sdd-cli 0.1.0

package/templates/functional-spec.md

@@ -0,0 +1,22 @@
+# Functional Spec: {{title}}
+
+## Overview
+{{overview}}
+
+## Actors
+{{actors}}
+
+## Use cases
+{{use_cases}}
+
+## Flows
+{{flows}}
+
+## Business rules
+{{rules}}
+
+## Errors and exceptions
+{{errors}}
+
+## Acceptance criteria
+{{acceptance_criteria}}

package/templates/gate-index.json

@@ -0,0 +1,20 @@
+{
+  "gates": [
+    { "id": "objective_defined", "description": "Objective is defined" },
+    { "id": "scope_defined", "description": "Scope is defined" },
+    { "id": "acceptance_criteria_defined", "description": "Acceptance criteria defined" },
+    { "id": "nfrs_defined", "description": "NFRs defined" },
+    { "id": "test_plan_defined", "description": "Test plan defined" },
+    { "id": "quality_thresholds_defined", "description": "Quality thresholds defined" },
+    { "id": "repro_steps_defined", "description": "Repro steps captured" },
+    { "id": "comment_audit_complete", "description": "PR comment audit complete" },
+    { "id": "comment_severity_defined", "description": "PR comment severity classified" },
+    { "id": "rollout_defined", "description": "Rollout plan defined" },
+    { "id": "monitoring_defined", "description": "Monitoring plan defined" },
+    { "id": "accessibility_defined", "description": "Accessibility requirements defined" },
+    { "id": "source_quality_defined", "description": "Source reliability defined" },
+    { "id": "sensitivity_defined", "description": "Sensitivity analysis defined" },
+    { "id": "compliance_defined", "description": "Compliance constraints defined" },
+    { "id": "learning_format_defined", "description": "Learning output format defined" }
+  ]
+}

package/templates/implementation-plan.md

@@ -0,0 +1,13 @@
+# Implementation Plan: {{title}}
+
+## Milestones
+{{milestones}}
+
+## Tasks
+{{tasks}}
+
+## Dependencies
+{{dependencies}}
+
+## Risks and mitigations
+{{risks}}

package/templates/pr-comment-audit.md

@@ -0,0 +1,19 @@
+# PR Comment Audit: {{title}}
+
+## PR link
+{{pr_link}}
+
+## Comment inventory
+{{comment_inventory}}
+
+## Valid comments
+{{valid_comments}}
+
+## Debatable comments
+{{debatable_comments}}
+
+## Recommended responses
+{{recommended_responses}}
+
+## Follow-ups
+{{follow_ups}}

package/templates/pr-comment-lifecycle.md

@@ -0,0 +1,11 @@
+# PR Comment Lifecycle
+
+## Status values
+- open
+- accepted
+- challenged
+- deferred
+- resolved
+
+## Log entries
+{{entries}}

package/templates/pr-comment-severity.md

@@ -0,0 +1,13 @@
+# PR Comment Severity Rubric
+
+## Levels
+- **Blocker**: Must fix before merge (correctness, security, data loss).
+- **High**: Important improvement (performance, reliability).
+- **Medium**: Quality improvement (readability, maintainability).
+- **Low**: Minor polish (naming, formatting).
+
+## Evaluation questions
+- Does it affect correctness or safety?
+- Does it change public behavior or API?
+- Does it create test gaps or regressions?
+- Is it required by project standards?

package/templates/pr-dispute-resolution.md

@@ -0,0 +1,16 @@
+# PR Dispute Resolution
+
+## Disputed comment
+{{comment}}
+
+## Context
+{{context}}
+
+## Evidence
+{{evidence}}
+
+## Proposed response
+{{response}}
+
+## Follow-up action
+{{follow_up}}

package/templates/pr-metrics.md

@@ -0,0 +1,10 @@
+# PR Metrics Summary
+
+## Metrics
+- Total comments: {{total_comments}}
+- Blockers: {{blockers}}
+- Avg time to resolve: {{avg_time_to_resolve}}
+- Tests run: {{tests_run}}
+
+## Notes
+{{notes}}

package/templates/pr-response-generator.md

@@ -0,0 +1,11 @@
+# PR Response Generator
+
+## Input
+- PR link: {{pr_link}}
+- Comment ID: {{comment_id}}
+- Severity: {{severity}}
+- Decision: {{decision}} (accept/clarify/disagree/defer)
+- Evidence: {{evidence}}
+
+## Suggested response
+{{response_text}}

package/templates/pr-response-style.md

@@ -0,0 +1,13 @@
+# PR Response Style Guide
+
+## Principles
+- Be concise and respectful.
+- Acknowledge valid feedback explicitly.
+- Provide evidence for disagreements.
+- Offer an alternative if rejecting a suggestion.
+
+## Response patterns
+- **Accept**: "Good catch. I applied the change in <file>."
+- **Clarify**: "I updated this to <behavior>, which matches <reason>."
+- **Disagree**: "I reviewed this. The current approach is required because <evidence>."
+- **Defer**: "I agree, but it is out of scope for this PR. I created a follow-up issue."

package/templates/pr-review-report.md

@@ -0,0 +1,22 @@
+# PR Review Report: {{title}}
+
+## Overview
+- PR link: {{pr_link}}
+- Summary: {{summary}}
+
+## Comment status
+- Total: {{total_comments}}
+- Resolved: {{resolved_comments}}
+- Open: {{open_comments}}
+
+## Key decisions
+{{key_decisions}}
+
+## Changes made
+{{changes_made}}
+
+## Test evidence
+{{test_evidence}}
+
+## Remaining risks
+{{remaining_risks}}

package/templates/pr-review-summary.md

@@ -0,0 +1,16 @@
+# PR Review Summary: {{title}}
+
+## PR link
+{{pr_link}}
+
+## Comment audit
+{{comment_audit}}
+
+## Proposed responses
+{{responses}}
+
+## Planned fixes
+{{planned_fixes}}
+
+## Tests
+{{tests}}

package/templates/progress-log.md

@@ -0,0 +1,6 @@
+# Progress Log
+
+## {{date}}
+- Summary: {{summary}}
+- Risks: {{risks}}
+- Next steps: {{next_steps}}

package/templates/project-readme.md

@@ -0,0 +1,19 @@
+# {{project_name}}
+
+## Overview
+{{overview}}
+
+## How to run
+{{how_to_run}}
+
+## Architecture
+{{architecture_summary}}
+
+## Specs
+- Requirements: {{requirements_link}}
+- Functional spec: {{functional_spec_link}}
+- Technical spec: {{technical_spec_link}}
+- Architecture: {{architecture_link}}
+
+## Testing
+{{testing_notes}}

package/templates/prompt-pack-index.json

@@ -0,0 +1,127 @@
+{
+  "packs": [
+    {
+      "id": "discovery.core",
+      "questions": [
+        "What is the objective?",
+        "Who are the users and actors?",
+        "What is in scope and out of scope?",
+        "What are the acceptance criteria?",
+        "What NFRs apply (security, performance, availability)?",
+        "What are the critical paths and edge cases?",
+        "What coverage and complexity thresholds apply?"
+      ],
+      "gates": [
+        "objective_defined",
+        "scope_defined",
+        "acceptance_criteria_defined",
+        "nfrs_defined",
+        "test_plan_defined",
+        "quality_thresholds_defined"
+      ]
+    },
+    {
+      "id": "bug_fix.core",
+      "questions": [
+        "Expected vs actual behavior?",
+        "Steps to reproduce?",
+        "Environment and version?",
+        "Severity and impact?"
+      ],
+      "gates": [
+        "repro_steps_defined"
+      ]
+    },
+    {
+      "id": "pr_review.core",
+      "questions": [
+        "PR link and target branch?",
+        "Blocking comments?",
+        "Tests required?"
+      ],
+      "gates": [
+        "comment_audit_complete"
+      ]
+    },
+    {
+      "id": "review.severity",
+      "questions": [
+        "Which comments are blockers vs minor?",
+        "Which comments affect correctness or safety?"
+      ],
+      "gates": [
+        "comment_severity_defined"
+      ]
+    },
+    {
+      "id": "release.rollout",
+      "questions": [
+        "What is the rollout plan?",
+        "What metrics define success?"
+      ],
+      "gates": [
+        "rollout_defined"
+      ]
+    },
+    {
+      "id": "data.monitoring",
+      "questions": [
+        "How will model drift be monitored?",
+        "What alerts are required?"
+      ],
+      "gates": [
+        "monitoring_defined"
+      ]
+    },
+    {
+      "id": "design.accessibility",
+      "questions": [
+        "What accessibility standards apply?",
+        "What contrast or usability checks are required?"
+      ],
+      "gates": [
+        "accessibility_defined"
+      ]
+    },
+    {
+      "id": "humanities.sources",
+      "questions": [
+        "What sources are acceptable?",
+        "How will source reliability be assessed?"
+      ],
+      "gates": [
+        "source_quality_defined"
+      ]
+    },
+    {
+      "id": "business.sensitivity",
+      "questions": [
+        "What sensitivity analysis is required?",
+        "What assumptions are most risky?"
+      ],
+      "gates": [
+        "sensitivity_defined"
+      ]
+    },
+    {
+      "id": "legal.compliance",
+      "questions": [
+        "What compliance constraints apply?",
+        "What retention/audit rules are required?"
+      ],
+      "gates": [
+        "compliance_defined"
+      ]
+    },
+    {
+      "id": "learn.format",
+      "questions": [
+        "What output format do you want?",
+        "What depth is required?"
+      ],
+      "gates": [
+        "learning_format_defined"
+      ]
+    }
+  ]
+}

package/templates/quality.yml

@@ -0,0 +1,17 @@
+rules:
+  - single-responsibility
+  - explicit-error-handling
+  - lint-and-format-required
+  - tests-for-critical-flows
+thresholds:
+  coverage: "80%"
+  complexity: "10"
+profiles:
+  javascript:
+    - eslint
+    - prettier
+    - vitest
+  python:
+    - ruff
+    - black
+    - pytest

package/templates/requirement.md

@@ -0,0 +1,33 @@
+# Requirement: {{title}}
+
+## ID
+{{id}}
+
+## Objective
+{{objective}}
+
+## Actors
+{{actors}}
+
+## Scope (in)
+{{scope_in}}
+
+## Scope (out)
+{{scope_out}}
+
+## Acceptance criteria
+{{acceptance_criteria}}
+
+## Non-functional requirements
+- Security: {{nfr_security}}
+- Performance: {{nfr_performance}}
+- Availability: {{nfr_availability}}
+
+## Constraints
+{{constraints}}
+
+## Risks
+{{risks}}
+
+## Links
+{{links}}

package/templates/summary.md

@@ -0,0 +1,10 @@
+# Summary
+
+## Objective
+{{objective}}
+
+## Key decisions
+{{decisions}}
+
+## Open questions
+{{open_questions}}

package/templates/technical-spec.md

@@ -0,0 +1,22 @@
+# Technical Spec: {{title}}
+
+## Stack
+{{stack}}
+
+## Interfaces and contracts
+{{interfaces}}
+
+## Data model
+{{data_model}}
+
+## Security
+{{security}}
+
+## Errors
+{{errors}}
+
+## Performance
+{{performance}}
+
+## Observability
+{{observability}}

package/templates/template-index.json

@@ -0,0 +1,212 @@
+{
+  "templates": [
+    {
+      "name": "requirement",
+      "placeholders": [
+        "title",
+        "id",
+        "objective",
+        "actors",
+        "scope_in",
+        "scope_out",
+        "acceptance_criteria",
+        "nfr_security",
+        "nfr_performance",
+        "nfr_availability",
+        "constraints",
+        "risks",
+        "links"
+      ]
+    },
+    {
+      "name": "functional-spec",
+      "placeholders": [
+        "title",
+        "overview",
+        "actors",
+        "use_cases",
+        "flows",
+        "rules",
+        "errors",
+        "acceptance_criteria"
+      ]
+    },
+    {
+      "name": "technical-spec",
+      "placeholders": [
+        "title",
+        "stack",
+        "interfaces",
+        "data_model",
+        "security",
+        "errors",
+        "performance",
+        "observability"
+      ]
+    },
+    {
+      "name": "architecture",
+      "placeholders": [
+        "title",
+        "context",
+        "containers",
+        "components",
+        "deployment",
+        "diagrams"
+      ]
+    },
+    {
+      "name": "test-plan",
+      "placeholders": [
+        "title",
+        "critical_paths",
+        "edge_cases",
+        "acceptance_tests",
+        "regressions",
+        "coverage_target"
+      ]
+    },
+    {
+      "name": "quality",
+      "placeholders": [
+        "rules",
+        "thresholds",
+        "profiles"
+      ]
+    },
+    {
+      "name": "decision-log",
+      "placeholders": [
+        "id",
+        "title",
+        "status",
+        "context",
+        "decision",
+        "consequences",
+        "date"
+      ]
+    },
+    {
+      "name": "progress-log",
+      "placeholders": [
+        "date",
+        "summary",
+        "risks",
+        "next_steps"
+      ]
+    },
+    {
+      "name": "project-readme",
+      "placeholders": [
+        "project_name",
+        "overview",
+        "how_to_run",
+        "architecture_summary",
+        "requirements_link",
+        "functional_spec_link",
+        "technical_spec_link",
+        "architecture_link",
+        "testing_notes"
+      ]
+    },
+    {
+      "name": "summary",
+      "placeholders": [
+        "objective",
+        "decisions",
+        "open_questions"
+      ]
+    },
+    {
+      "name": "changelog",
+      "placeholders": [
+        "date"
+      ]
+    },
+    {
+      "name": "implementation-plan",
+      "placeholders": [
+        "title",
+        "milestones",
+        "tasks",
+        "dependencies",
+        "risks"
+      ]
+    },
+    {
+      "name": "pr-comment-audit",
+      "placeholders": [
+        "title",
+        "pr_link",
+        "comment_inventory",
+        "valid_comments",
+        "debatable_comments",
+        "recommended_responses",
+        "follow_ups"
+      ]
+    },
+    {
+      "name": "pr-review-summary",
+      "placeholders": [
+        "title",
+        "pr_link",
+        "comment_audit",
+        "responses",
+        "planned_fixes",
+        "tests"
+      ]
+    },
+    {
+      "name": "pr-review-report",
+      "placeholders": [
+        "title",
+        "pr_link",
+        "summary",
+        "total_comments",
+        "resolved_comments",
+        "open_comments",
+        "key_decisions",
+        "changes_made",
+        "test_evidence",
+        "remaining_risks"
+      ]
+    },
+    {
+      "name": "pr-metrics",
+      "placeholders": [
+        "total_comments",
+        "blockers",
+        "avg_time_to_resolve",
+        "tests_run",
+        "notes"
+      ]
+    },
+    {
+      "name": "pr-comment-lifecycle",
+      "placeholders": [
+        "entries"
+      ]
+    },
+    {
+      "name": "pr-response-generator",
+      "placeholders": [
+        "pr_link",
+        "comment_id",
+        "severity",
+        "decision",
+        "evidence",
+        "response_text"
+      ]
+    },
+    {
+      "name": "pr-dispute-resolution",
+      "placeholders": [
+        "comment",
+        "context",
+        "evidence",
+        "response",
+        "follow_up"
+      ]
+    }
+  ]
+}

package/templates/test-plan.md

@@ -0,0 +1,16 @@
+# Test Plan: {{title}}
+
+## Critical paths
+{{critical_paths}}
+
+## Edge cases
+{{edge_cases}}
+
+## Acceptance tests
+{{acceptance_tests}}
+
+## Regression tests
+{{regressions}}
+
+## Coverage target
+{{coverage_target}}