mao-sdd

SDD Phase 0 — Define governance principles, coding standards, quality gates, and TDD policy. Enhanced: validates context.json, updates pipeline state, suggests workspace creation.

SDD Phase 1 — User Specs from natural language. FR-NNN, SC-NNN, acceptance scenarios. Enhanced: bug-fix intent detection, semantic diff on re-run, workspace RAG capture.

SDD Phase 2 — Technical Specs: architecture, data model, API contracts, technology decisions. Enhanced: Tessl tile discovery, context validation, schema enforcement.

SDD Phase 3 — BDD Analysis quality checklists. [GATE G1] Enhanced: mandatory gate enforcement, FR→plan alignment check.

SDD Phase 4 — Gherkin BDD test specs with cryptographic assertion hashing. Enhanced: SHA-256 hash generation, traceability tag validation, assertion integrity.

SDD Phase 5 — Dependency-ordered task breakdown with parallel markers and story labels.

SDD Phase 6 — Cross-artifact consistency validation, traceability FR→TS→Tasks. Enhanced: knowledge graph rebuild, orphan detection, health scoring.

SDD Phase 7 — Iterative TDD implementation with BDD verification chain. [GATE G2] Enhanced: mandatory gate, step coverage verification, assertion integrity, feature immutability.

SDD Phase 8 — Export tasks to GitHub Issues with labels and dependencies. [GATE G3] Enhanced: mandatory gate, issue-map tracking, cross-check verification.

SDD Bug report + fix tasks. Enhanced: Quick Flow triage, GitHub issue inbound (#number), scope guard against AP-06 (consecutive quick flows).

SDD Utility — Resolve ambiguities in any artifact at any phase. Enhanced: auto-detect artifact, structured questions per ambiguity taxonomy, RAG capture.

SDD project initialization, status, feature selection, and help. Enhanced fork of iikit-core with workspace sessions, heartbeat init, ALM deployment, and SDD branding.

This skill should be used when the user asks to "capture input", "save to RAG memory", "index a file", "store reference material", "capture document for context", or "add to knowledge base". It captures session inputs as RAG memory files with frontmatter, abstract, key takeaways, and full content. Workspace-aware routing sends captures to the active workspace's rag/ folder. Use this skill whenever the user mentions capture, RAG, memory indexing, or knowledge base storage.

This skill should be used when the user asks to "generate dashboard", "refresh dashboard", "build command center", "update ALM views", "regenerate pipeline visualization", or "open dashboard". It generates both the single-file dashboard and the multi-page ALM Command Center with all views (pipeline, specs, quality, intelligence, workspace, governance, logs, backlog, search). Use this skill whenever the user mentions dashboard, command center, ALM, or pipeline visualization.

This skill should be used when the user asks to "run a demo", "show me how SDD works", "generate a demo project", "create a sample project", "demonstrate the pipeline", or "try SDD with example data". It generates a complete demo project with realistic features, specs, tests, tasks, and opens the dashboard for exploration. Use this skill whenever the user mentions demo, demonstration, sample project, or try SDD.

This skill should be used when the user asks to "create a feature", "select a feature", "list features", "switch feature", "add new feature to project", or "manage features". It creates, selects, and lists features in the specs/ directory with proper numbering and directory structure. Use this skill whenever the user mentions feature creation, feature selection, or feature management.

This skill should be used when the user asks to "build knowledge graph", "trace requirements", "show traceability", "map dependencies between artifacts", "visualize requirement flow", or "detect orphan nodes". It builds a knowledge graph tracing Constitution principles to requirements, tests, and tasks with edge types (governs, verified_by, implemented_by, validates). Use this skill whenever the user mentions knowledge graph, traceability, orphan detection, or requirement mapping.

This skill should be used when the user asks to "install hooks", "set up git hooks", "enable assertion integrity", "install pre-commit hooks", "configure commit validation", or "protect test hashes". It installs git pre-commit and post-commit hooks that enforce assertion integrity by validating .feature file SHA-256 hashes on every commit. Use this skill whenever the user mentions hooks, assertion integrity, or commit validation.

This skill should be used when the user asks to "show insights", "analyze health trends", "view risk indicators", "get smart recommendations", "show traceability analysis", or "review pipeline intelligence". It runs the insights engine to produce health scores, traceability analysis, risk indicators, and AI-powered recommendations. Use this skill whenever the user mentions insights, trends, risk analysis, or recommendations.

This skill should be used when the user asks to "browse RAG memory", "search captures", "list memory files", "find past inputs", "show knowledge base", or "review stored context". It browses and searches the RAG memory archive indexed in rag-index.json. Use this skill whenever the user mentions memory browsing, RAG search, captured files, or knowledge base exploration.

This skill should be used when the user asks to "show menu", "list all commands", "what commands are available", "show command palette", "help with SDD commands", or "what can SDD do". It displays the interactive command palette organized by category (pipeline, intelligence, utility, experience) with descriptions and aliases. Use this skill whenever the user mentions menu, command list, help, or available commands.

This skill should be used when the user asks to "generate QA plan", "refresh QA plan", "check definition of done", "review acceptance criteria", "audit gate status", or "validate quality gates". It generates QA-PLAN.md and qa-plan.json with Definition of Done, acceptance criteria per feature, and G1/G2/G3 gate status. Use this skill whenever the user mentions QA plan, quality gates, DoD, or acceptance criteria.

This skill should be used when the user asks to "seed demo data", "generate sample data", "populate project with examples", "create test fixtures", "seed without dashboard", or "just create the demo files". It seeds demo data (3 features with pipeline artifacts) without opening the dashboard. Use this skill when the user wants demo data only, not the full demo experience with dashboard.

This skill should be used when the user asks to "run sentinel", "check project health", "scan for drift", "detect stale artifacts", "run perceive-decide-act cycle", or "audit pipeline state". It executes a full sentinel cycle (perceive-decide-act) with zero LLM cost to detect stale artifacts, missing files, health regression, and drift from constitution principles. Use this skill whenever the user mentions sentinel, health check, drift detection, or pipeline audit.

This skill should be used when the user asks to "create a new SDD skill", "scaffold a skill", "forge a skill", "build a new command", or mentions "skill creator". It manufactures production-grade SDD/IIKit skills with full scaffolding: SKILL.md, scripts, templates, references, hooks, evals, and knowledge graph registration. Use this skill whenever a new pipeline phase, utility command, or experience skill is needed — even if the user just says "I need a new /sdd command".

This skill should be used when the user asks to "check status", "show pipeline status", "view progress", "what phase am I on", "show feature stages", or "display pipeline overview". It runs the status script to display a visual pipeline table with phase dots, feature stages, and next step recommendations. Use this skill whenever the user mentions status, progress, pipeline overview, or current phase.

This skill should be used when the user asks to "sync upstream", "update from IIC/kit", "pull latest framework", "sync intent integrity chain", "update SDD engine", or "reapply brand overlay". It syncs the upstream IIC/kit repository and reapplies the MetodologIA brand layer. Use this skill whenever the user mentions sync, upstream, IIC/kit update, or brand reapplication.

This skill should be used when the user asks to "start tour", "onboard me to SDD", "show me around", "walk me through the pipeline", "how does SDD work", or "give me a guided introduction". It runs an 8-step interactive walkthrough of the SDD pipeline covering constitution, specs, plan, checklist, testify, tasks, analyze, implement, and ship. Use this skill for onboarding, orientation, or learning SDD.

This skill should be used when the user asks to "verify project", "run verification", "check integrity", "validate structure", "audit assertions", "verify brand compliance", or "run checks". It executes the 8-check verification suite covering structure, brand, tokens, assertions, and workspace integrity. Use this skill whenever the user mentions verify, validate, integrity check, or compliance audit.

This skill should be used when the user asks to "create workspace", "list workspaces", "select workspace", "archive workspace", "manage workspace sessions", or "switch task context". It manages per-task workspace sessions with isolated inputs, RAG files, logs, and tasklog per interaction. Use this skill whenever the user mentions workspace, session management, task isolation, or context switching.