sparc-mapping

Map SPARC phases onto lifecycle steps and append a Pseudocode gate section.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/ToanPV90/dotfiles --skill sparc-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sparc-mapping
Source: https://github.com/ToanPV90/dotfiles/tree/main/claude/.claude/skills/sparc-mapping
Command: npx skills add https://github.com/ToanPV90/dotfiles --skill sparc-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents development plans from jumping from architecture straight into implementation by forcing an explicit Pseudocode checkpoint for algorithmic work.

Core Features & Use Cases

  • SPARC phase mapping: Maps Specification, Architecture, Refinement, and Completion to the lifecycle artifacts you already use, while highlighting the missing Pseudocode gate.
  • Pseudocode gate scaffolding: Triage-compares a candidate plan against rules for when a Pseudocode gate is needed, then appends a structured ## Pseudocode section with placeholders for 1–5 critical functions.
  • Interactive human review loop: Prompts you to draft the pseudocode, then checks whether edge cases, invariants, and failure modes are explicitly named before handing off to execution.
  • Phase status reporting: Detects which SPARC phases the current plan has evidence for by inspecting plan structure and related signals.

Quick Start

Ask the AI to run: /sparc-mapping pseudocode-gate path/to/your-plan.md.

Frequently Asked Questions about sparc-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a pseudocode checkpoint to my development plan?

To add a pseudocode checkpoint to your development plan, you map SPARC phases onto existing lifecycle steps and append a structured ## Pseudocode section with placeholders for critical functions. This forces explicit edge cases and failure modes before execution.

When do I need a pseudocode gate for algorithm design?

A pseudocode gate is needed for algorithm design when handling non-trivial control flow, state machines, concurrency, and algorithmic data transforms. It prevents jumping straight from architecture to implementation by forcing a human-authored pseudocode scaffold.

How does SPARC phase mapping work with existing lifecycle artifacts?

SPARC phase mapping works by aligning Specification, Architecture, Refinement, and Completion phases with the lifecycle artifacts you already use. It highlights the missing Pseudocode gate and reports which phases your current plan has evidence for.

What is the best way to de-risk an architecture plan before coding?

The best way to de-risk an architecture plan before coding is to run an interactive human review loop that drafts pseudocode for critical functions. This ensures edge cases, invariants, and failure modes are explicitly named before passing to execution.

Can I use SPARC mapping if my plan has no pseudocode section?

Yes, you can use SPARC mapping if your plan has no pseudocode section. The skill triages gate necessity by comparing your candidate plan against rules, then appends a structured ## Pseudocode section at the correct location with 1–5 critical function subsections.

Why does my development plan skip edge cases and failure modes?

Your development plan skips edge cases and failure modes because it lacks an explicit pseudocode checkpoint between architecture and implementation. Adding a pseudocode gate enforces an interactive review loop that checks whether these constraints are explicitly named.