sdd-cli 0.1.0

package/router/LEGAL.flow.md

@@ -0,0 +1,58 @@
+# Router flow: Legal / civic
+
+## Entry signals
+- "law", "court", "policy", "compliance", "contract"
+
+## Steps
+1) Interview for jurisdiction, confidentiality, and actors.
+2) Define legal constraints and evidence requirements.
+3) Generate requirements and risk checks.
+4) Ask for approval or `--improve`.
+5) Produce audit and retention guidelines.
+
+## Required questions
+- What jurisdiction and regulations apply?
+- What data is privileged or sensitive?
+- Who are the actors and access levels?
+- What retention and audit rules exist?
+- What outcomes or deliverables are required?
+
+## Required outputs
+- `requirement.md`
+- `functional-spec.md`
+- `technical-spec.md`
+- `architecture.md`
+- `test-plan.md` (access and audit checks)
+
+## Scripted Q/A tree
+
+### Q1: Jurisdiction
+Q: "What jurisdiction and regulations apply?"  
+A: capture jurisdiction and constraints
+
+### Q2: Sensitivity
+Q: "What data is privileged or sensitive?"  
+A: capture data sensitivity
+
+### Q3: Actors
+Q: "Who are the actors and access levels?"  
+A: capture roles and access
+
+### Q4: Retention
+Q: "What retention and audit rules exist?"  
+A: capture retention rules
+
+### Q5: Outcomes
+Q: "What outcomes or deliverables are required?"  
+A: capture deliverables
+
+### Q6: Approval gate
+Q: "Approve requirements and move to specs?"  
+A: Yes -> generate specs  
+A: No -> refine
+
+## Gates
+- Compliance constraints required before plan
+
+## Agents
+- Legal Analyst, Compliance, QA

package/router/PR_REVIEW.flow.md

@@ -0,0 +1,55 @@
+# Router flow: PR review
+
+## Entry signals
+- "PR", "pull request", "review comments", "code review"
+
+## Steps
+1) Ask permission to open PR link.
+2) Fetch PR details and comments (if approved).
+3) Summarize comments and classify by severity.
+4) Ask user to confirm understanding and add context.
+5) Run prework audit: validate if comments are correct or debatable.
+6) Propose fixes and alternatives.
+7) Generate requirements/specs for the changes.
+8) Gate implementation until test plan is defined.
+
+## Required questions
+- What is the PR link and target branch?
+- Are there blocking comments?
+- What tests are required?
+- Is there any deadline or release window?
+
+## Scripted Q/A tree
+
+### Q1: Link access
+Q: "Do you approve opening the PR link?"  
+A: Yes -> fetch + summarize  
+A: No -> ask for pasted comments
+
+### Q2: User perspective
+Q: "Do you agree with the comments? Any context we should know?"  
+A: capture user insights
+
+### Q3: Prework audit
+Q: "Should we challenge or accept any comment? If so, why?"  
+A: capture constraints and rationale
+
+### Q4: Approval gate
+Q: "Approve plan to address comments and generate specs?"  
+A: Yes -> generate artifacts  
+A: No -> refine
+
+## Required outputs
+- `requirement.md`
+- `technical-spec.md`
+- `test-plan.md`
+- `progress-log.md`
+- `pr-comment-audit.md`
+- `pr-review-summary.md`
+
+## Gates
+- All comments reviewed before proposing fixes
+- Test plan required before implementation
+
+## Agents
+- Reviewer, Tech Lead, QA

package/router/README.md

@@ -0,0 +1,23 @@
+# Router scripts
+
+These scripts define intent detection and the step-by-step conversation for each flow.
+
+Each script includes:
+- Entry signals
+- Required questions
+- Required outputs
+- Gate checks
+- Suggested agent roles
+- Scripted Q/A tree with optional branches
+
+Available flows:
+- BUG_FIX
+- LEARN
+- SOFTWARE_FEATURE
+- DATA_SCIENCE
+- DESIGN
+- HUMANITIES
+- BUSINESS
+- LEGAL
+- PR_REVIEW
+- GENERIC

package/router/SOFTWARE_FEATURE.flow.md

@@ -0,0 +1,59 @@
+# Router flow: Software feature
+
+## Entry signals
+- "feature", "build", "implement", "API", "backend", "frontend"
+
+## Steps
+1) Run discovery and acceptance criteria prompts.
+2) Generate requirements and functional spec.
+3) Generate technical spec and architecture.
+4) Ask for approval or `--improve`.
+5) Activate quality profile and test plan.
+
+## Required questions
+- What problem is solved and for whom?
+- What is in scope/out of scope?
+- What are acceptance criteria?
+- What performance/security constraints apply?
+- What is the rollout strategy?
+
+## Required outputs
+- `requirement.md`
+- `functional-spec.md`
+- `technical-spec.md`
+- `architecture.md`
+- `test-plan.md`
+- `quality.yml`
+
+## Scripted Q/A tree
+
+### Q1: Problem and users
+Q: "What problem are we solving and for whom?"  
+A: capture user/persona and objective
+
+### Q2: Scope
+Q: "What is in scope and out of scope?"  
+A: capture scope boundaries
+
+### Q3: Acceptance criteria
+Q: "What are the acceptance criteria?"  
+A: capture verifiable criteria
+
+### Q4: Constraints
+Q: "Any performance, security, or compatibility constraints?"  
+A: capture NFRs
+
+### Q5: Rollout
+Q: "How should we rollout and measure success?"  
+A: capture rollout + metrics
+
+### Q6: Approval gate
+Q: "Approve requirements and move to specs?"  
+A: Yes -> generate specs  
+A: No -> refine
+
+## Gates
+- No implementation without acceptance criteria and test plan
+
+## Agents
+- Req Analyst, Solution Architect, Tech Lead, QA

package/schemas/architecture.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Architecture",
+  "type": "object",
+  "required": ["context", "containers", "components"],
+  "properties": {
+    "context": { "type": "string" },
+    "containers": { "type": "array", "items": { "type": "string" } },
+    "components": { "type": "array", "items": { "type": "string" } },
+    "deployment": { "type": "array", "items": { "type": "string" } },
+    "diagrams": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/decision-log.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Decision Log (ADR)",
+  "type": "object",
+  "required": ["id", "title", "status", "context", "decision", "consequences", "date"],
+  "properties": {
+    "id": { "type": "string" },
+    "title": { "type": "string" },
+    "status": { "type": "string", "enum": ["proposed", "accepted", "rejected", "superseded"] },
+    "context": { "type": "string" },
+    "decision": { "type": "string" },
+    "consequences": { "type": "string" },
+    "date": { "type": "string" },
+    "supersedes": { "type": "string" }
+  }
+}

package/schemas/diagram.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Diagram",
+  "type": "object",
+  "required": ["type", "path"],
+  "properties": {
+    "type": { "type": "string", "enum": ["context", "container", "component"] },
+    "path": { "type": "string" },
+    "format": { "type": "string", "enum": ["mermaid", "plantuml"] }
+  }
+}

package/schemas/domain.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Domain",
+  "type": "string",
+  "enum": [
+    "software",
+    "bug_fix",
+    "pr_review",
+    "data_science",
+    "design",
+    "art",
+    "history",
+    "sociology",
+    "economics",
+    "legal",
+    "education",
+    "business",
+    "learning"
+  ]
+}

package/schemas/functional-spec.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Functional Spec",
+  "type": "object",
+  "required": ["overview", "useCases", "rules", "acceptanceCriteria"],
+  "properties": {
+    "overview": { "type": "string" },
+    "actors": { "type": "array", "items": { "type": "string" } },
+    "useCases": { "type": "array", "items": { "type": "string" } },
+    "flows": { "type": "array", "items": { "type": "string" } },
+    "rules": { "type": "array", "items": { "type": "string" } },
+    "errors": { "type": "array", "items": { "type": "string" } },
+    "acceptanceCriteria": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/gate.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Gate",
+  "type": "object",
+  "required": ["id", "description"],
+  "properties": {
+    "id": { "type": "string" },
+    "description": { "type": "string" }
+  }
+}

package/schemas/learn-session.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Learn Session",
+  "type": "object",
+  "required": ["topic", "depth", "format", "focusAreas", "purpose"],
+  "properties": {
+    "topic": { "type": "string" },
+    "depth": { "type": "string", "enum": ["overview", "academic", "expert"] },
+    "format": { "type": "string", "enum": ["summary", "syllabus", "report", "qa"] },
+    "focusAreas": { "type": "array", "items": { "type": "string" } },
+    "constraints": { "type": "array", "items": { "type": "string" } },
+    "purpose": { "type": "string" },
+    "timeBudget": { "type": "string" }
+  }
+}

package/schemas/pr-review.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "PR Review",
+  "type": "object",
+  "required": ["prLink", "comments", "audit", "responses", "tests"],
+  "properties": {
+    "prLink": { "type": "string" },
+    "comments": { "type": "array", "items": { "type": "string" } },
+    "audit": {
+      "type": "object",
+      "required": ["valid", "debatable"],
+      "properties": {
+        "valid": { "type": "array", "items": { "type": "string" } },
+        "debatable": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "responses": { "type": "array", "items": { "type": "string" } },
+    "tests": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/progress-log.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Progress Log",
+  "type": "object",
+  "required": ["entries"],
+  "properties": {
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["date", "summary"],
+        "properties": {
+          "date": { "type": "string" },
+          "summary": { "type": "string" },
+          "risks": { "type": "array", "items": { "type": "string" } },
+          "nextSteps": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    }
+  }
+}

package/schemas/project-readme.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Project README",
+  "type": "object",
+  "required": ["projectName", "overview", "howToRun", "architectureSummary", "specs", "testingNotes"],
+  "properties": {
+    "projectName": { "type": "string" },
+    "overview": { "type": "string" },
+    "howToRun": { "type": "string" },
+    "architectureSummary": { "type": "string" },
+    "specs": {
+      "type": "object",
+      "required": ["requirements", "functionalSpec", "technicalSpec", "architecture"],
+      "properties": {
+        "requirements": { "type": "string" },
+        "functionalSpec": { "type": "string" },
+        "technicalSpec": { "type": "string" },
+        "architecture": { "type": "string" }
+      }
+    },
+    "testingNotes": { "type": "string" }
+  }
+}

package/schemas/project.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Project Metadata",
+  "type": "object",
+  "required": ["id", "name", "domain", "status", "path", "updatedAt"],
+  "properties": {
+    "id": { "type": "string" },
+    "name": { "type": "string" },
+    "domain": { "type": "string" },
+    "status": { "type": "string", "enum": ["backlog", "wip", "in-progress", "done", "archived"] },
+    "path": { "type": "string" },
+    "languageProfile": { "type": "string" },
+    "qualityProfile": { "type": "string" },
+    "updatedAt": { "type": "string" }
+  }
+}

package/schemas/prompt-pack.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Prompt Pack",
+  "type": "object",
+  "required": ["id", "questions", "gates"],
+  "properties": {
+    "id": { "type": "string" },
+    "questions": { "type": "array", "items": { "type": "string" } },
+    "gates": { "type": "array", "items": { "type": "string" } },
+    "followUps": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/quality.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Quality Contract",
+  "type": "object",
+  "required": ["rules", "profiles", "thresholds"],
+  "properties": {
+    "rules": { "type": "array", "items": { "type": "string" } },
+    "thresholds": {
+      "type": "object",
+      "properties": {
+        "coverage": { "type": "string" },
+        "complexity": { "type": "string" }
+      }
+    },
+    "profiles": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/requirement.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Requirement",
+  "type": "object",
+  "required": ["id", "title", "objective", "scope", "acceptanceCriteria", "nfrs", "status"],
+  "properties": {
+    "id": { "type": "string" },
+    "title": { "type": "string" },
+    "objective": { "type": "string" },
+    "status": { "type": "string", "enum": ["backlog", "wip", "in-progress", "done", "archived"] },
+    "actors": { "type": "array", "items": { "type": "string" } },
+    "scope": {
+      "type": "object",
+      "required": ["in", "out"],
+      "properties": {
+        "in": { "type": "array", "items": { "type": "string" } },
+        "out": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "acceptanceCriteria": { "type": "array", "items": { "type": "string" } },
+    "nfrs": {
+      "type": "object",
+      "properties": {
+        "security": { "type": "string" },
+        "performance": { "type": "string" },
+        "availability": { "type": "string" }
+      }
+    },
+    "constraints": { "type": "array", "items": { "type": "string" } },
+    "risks": { "type": "array", "items": { "type": "string" } },
+    "links": { "type": "array", "items": { "type": "string" } },
+    "updatedAt": { "type": "string" }
+  }
+}

package/schemas/role.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agent Role",
+  "type": "string",
+  "enum": [
+    "req_analyst",
+    "solution_architect",
+    "tech_lead",
+    "qa",
+    "docs_scribe",
+    "reviewer",
+    "researcher",
+    "critic",
+    "synthesizer",
+    "analyst"
+  ]
+}

package/schemas/router-flow.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Router Flow",
+  "type": "object",
+  "required": ["id", "entrySignals", "steps", "questions", "outputs", "gates", "agents"],
+  "properties": {
+    "id": { "type": "string" },
+    "entrySignals": { "type": "array", "items": { "type": "string" } },
+    "steps": { "type": "array", "items": { "type": "string" } },
+    "questions": { "type": "array", "items": { "type": "string" } },
+    "outputs": { "type": "array", "items": { "type": "string" } },
+    "gates": { "type": "array", "items": { "type": "string" } },
+    "agents": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/router-intent.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Router Intent",
+  "type": "object",
+  "required": ["intent", "confidence", "flow", "domain"],
+  "properties": {
+    "intent": { "type": "string" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "flow": { "type": "string" },
+    "domain": { "$ref": "domain.schema.json" },
+    "signals": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/technical-spec.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Technical Spec",
+  "type": "object",
+  "required": ["stack", "interfaces", "dataModel", "security", "errors"],
+  "properties": {
+    "stack": { "type": "array", "items": { "type": "string" } },
+    "interfaces": { "type": "array", "items": { "type": "string" } },
+    "dataModel": { "type": "array", "items": { "type": "string" } },
+    "security": { "type": "array", "items": { "type": "string" } },
+    "errors": { "type": "array", "items": { "type": "string" } },
+    "performance": { "type": "array", "items": { "type": "string" } },
+    "observability": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/template.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Template Metadata",
+  "type": "object",
+  "required": ["name", "placeholders"],
+  "properties": {
+    "name": { "type": "string" },
+    "placeholders": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/test-plan.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Test Plan",
+  "type": "object",
+  "required": ["criticalPaths", "edgeCases", "coverageTarget", "acceptanceTests"],
+  "properties": {
+    "criticalPaths": { "type": "array", "items": { "type": "string" } },
+    "edgeCases": { "type": "array", "items": { "type": "string" } },
+    "coverageTarget": { "type": "string" },
+    "acceptanceTests": { "type": "array", "items": { "type": "string" } },
+    "regressions": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/workspace.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Workspace Index",
+  "type": "object",
+  "required": ["projects"],
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "$ref": "project.schema.json" }
+    }
+  }
+}

package/templates/architecture.md

@@ -0,0 +1,16 @@
+# Architecture: {{title}}
+
+## Context
+{{context}}
+
+## Containers
+{{containers}}
+
+## Components
+{{components}}
+
+## Deployment
+{{deployment}}
+
+## Diagrams
+{{diagrams}}

package/templates/changelog.md

@@ -0,0 +1,3 @@
+# Changelog
+
+- {{date}} Created requirement

package/templates/ci-checklist.md

@@ -0,0 +1,14 @@
+# CI Checklist
+
+## Required checks
+- Lint and format
+- Unit tests
+- Integration tests (if applicable)
+- Build succeeds
+
+## Evidence
+- Links to CI runs
+- Test summaries
+
+## Notes
+- Known limitations or deferred items

package/templates/decision-log.md

@@ -0,0 +1,16 @@
+# ADR {{id}}: {{title}}
+
+## Status
+{{status}}
+
+## Context
+{{context}}
+
+## Decision
+{{decision}}
+
+## Consequences
+{{consequences}}
+
+## Date
+{{date}}

package/templates/diagrams/component.mmd

@@ -0,0 +1,3 @@
+flowchart TB
+  Controller[Controller] --> Service[Service Layer]
+  Service --> Repo[Repository]

package/templates/diagrams/container.mmd

@@ -0,0 +1,3 @@
+flowchart TB
+  API[API Service] --> DB[(Database)]
+  API --> Cache[(Cache)]

package/templates/diagrams/context.mmd

@@ -0,0 +1,3 @@
+flowchart TB
+  User[User] --> App[System]
+  App --> External[External Services]