specsmith 0.1.4.dev35__tar.gz → 0.1.4.dev37__tar.gz

{specsmith-0.1.4.dev35/src/specsmith.egg-info → specsmith-0.1.4.dev37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.1.4.dev35
+Version: 0.1.4.dev37
 Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
 Author: BitConcepts
 License: MIT
@@ -79,14 +79,36 @@ pip install specsmith
 ## Quick Start
 
 ```bash
-specsmith init                                     # New project (interactive)
-specsmith init --config scaffold.yml               # New project (from config)
-specsmith import --project-dir ./my-project        # Adopt existing project
-specsmith audit --project-dir ./my-project         # Health check
-specsmith export --project-dir ./my-project        # Compliance report
-specsmith doctor --project-dir ./my-project        # Tool check
+# Install
+pip install specsmith
+
+# New project (interactive)
+specsmith init
+
+# Adopt an existing project
+specsmith import --project-dir ./my-project
+
+# Check governance health
+specsmith audit --project-dir ./my-project
+
+# Generate architecture docs interactively
+specsmith architect --project-dir ./my-project
+
+# Start an AI agent session (universal pattern)
+# From any governed repo root:
+/agent AGENTS.md
 ```
 
+### Starting an AI Agent Session
+
+The universal pattern for any specsmith-governed project:
+
+```
+/agent AGENTS.md
+```
+
+This works in Warp, Claude Code, Cursor, and any agent that reads markdown context files. The agent loads AGENTS.md (the governance hub), reads LEDGER.md for session state, and picks up from the last recorded action.
+
 ## 30 Project Types
 
 **Software:** Python, Rust, Go, C/C++, .NET, JS/TS, mobile, monorepo, microservices, DevOps/IaC, data/ML, browser extensions.
@@ -99,13 +121,14 @@ specsmith doctor --project-dir ./my-project        # Tool check
 
 Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
 
-## 30+ CLI Commands
+## 40+ CLI Commands
 
 | Command | Purpose |
 |---------|---------|
 | `init` | Scaffold a new governed project |
 | `import` | Adopt an existing project (merge mode) |
 | `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `architect` | Interactive architecture generation |
 | `validate` | Governance file consistency checks |
 | `compress` | Archive old ledger entries |
 | `upgrade` | Update governance to new spec version |
@@ -113,6 +136,8 @@ Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-s
 | `diff` | Compare governance against templates |
 | `export` | Compliance report with REQ↔TEST coverage |
 | `doctor` | Check if verification tools are installed |
+| `self-update` | Update specsmith (channel-aware) |
+| `credits` | AI credit tracking, analysis, and budgets |
 
 ## 7 Agent Integrations
 

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/README.md

@@ -36,14 +36,36 @@ pip install specsmith
 ## Quick Start
 
 ```bash
-specsmith init                                     # New project (interactive)
-specsmith init --config scaffold.yml               # New project (from config)
-specsmith import --project-dir ./my-project        # Adopt existing project
-specsmith audit --project-dir ./my-project         # Health check
-specsmith export --project-dir ./my-project        # Compliance report
-specsmith doctor --project-dir ./my-project        # Tool check
+# Install
+pip install specsmith
+
+# New project (interactive)
+specsmith init
+
+# Adopt an existing project
+specsmith import --project-dir ./my-project
+
+# Check governance health
+specsmith audit --project-dir ./my-project
+
+# Generate architecture docs interactively
+specsmith architect --project-dir ./my-project
+
+# Start an AI agent session (universal pattern)
+# From any governed repo root:
+/agent AGENTS.md
 ```
 
+### Starting an AI Agent Session
+
+The universal pattern for any specsmith-governed project:
+
+```
+/agent AGENTS.md
+```
+
+This works in Warp, Claude Code, Cursor, and any agent that reads markdown context files. The agent loads AGENTS.md (the governance hub), reads LEDGER.md for session state, and picks up from the last recorded action.
+
 ## 30 Project Types
 
 **Software:** Python, Rust, Go, C/C++, .NET, JS/TS, mobile, monorepo, microservices, DevOps/IaC, data/ML, browser extensions.
@@ -56,13 +78,14 @@ specsmith doctor --project-dir ./my-project        # Tool check
 
 Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
 
-## 30+ CLI Commands
+## 40+ CLI Commands
 
 | Command | Purpose |
 |---------|---------|
 | `init` | Scaffold a new governed project |
 | `import` | Adopt an existing project (merge mode) |
 | `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `architect` | Interactive architecture generation |
 | `validate` | Governance file consistency checks |
 | `compress` | Archive old ledger entries |
 | `upgrade` | Update governance to new spec version |
@@ -70,6 +93,8 @@ Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-s
 | `diff` | Compare governance against templates |
 | `export` | Compliance report with REQ↔TEST coverage |
 | `doctor` | Check if verification tools are installed |
+| `self-update` | Update specsmith (channel-aware) |
+| `credits` | AI credit tracking, analysis, and budgets |
 
 ## 7 Agent Integrations
 

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.1.4.dev35"
+version = "0.1.4.dev37"
 description = "Forge governed project scaffolds from the Agentic AI Development Workflow Specification."
 readme = "README.md"
 license = {text = "MIT"}

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/architect.py

@@ -148,7 +148,7 @@ def generate_architecture(
         doc += "\n"
 
     # Write
-    arch_path = root / "docs" / "architecture.md"
+    arch_path = root / "docs" / "ARCHITECTURE.md"
     arch_path.parent.mkdir(parents=True, exist_ok=True)
     arch_path.write_text(doc, encoding="utf-8")
     return arch_path

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/auditor.py

@@ -56,18 +56,20 @@ REQUIRED_FILES = [
 ]
 
 GOVERNANCE_FILES = [
-    "docs/governance/rules.md",
-    "docs/governance/workflow.md",
-    "docs/governance/roles.md",
-    "docs/governance/context-budget.md",
-    "docs/governance/verification.md",
-    "docs/governance/drift-metrics.md",
+    "docs/governance/RULES.md",
+    "docs/governance/WORKFLOW.md",
+    "docs/governance/ROLES.md",
+    "docs/governance/CONTEXT-BUDGET.md",
+    "docs/governance/VERIFICATION.md",
+    "docs/governance/DRIFT-METRICS.md",
 ]
 
 RECOMMENDED_FILES = [
     "docs/REQUIREMENTS.md",
     "docs/TEST_SPEC.md",
-    "docs/architecture.md",
+    "docs/ARCHITECTURE.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
 ]
 
 
@@ -294,33 +296,33 @@ def check_ledger_health(root: Path) -> list[AuditResult]:
 # Default thresholds (used when no project type is detected)
 _DEFAULT_THRESHOLDS: dict[str, int] = {
     "AGENTS.md": 200,
-    "docs/governance/rules.md": 800,
-    "docs/governance/workflow.md": 400,
-    "docs/governance/roles.md": 300,
-    "docs/governance/context-budget.md": 300,
-    "docs/governance/verification.md": 400,
-    "docs/governance/drift-metrics.md": 300,
+    "docs/governance/RULES.md": 800,
+    "docs/governance/WORKFLOW.md": 400,
+    "docs/governance/ROLES.md": 300,
+    "docs/governance/CONTEXT-BUDGET.md": 300,
+    "docs/governance/VERIFICATION.md": 400,
+    "docs/governance/DRIFT-METRICS.md": 300,
 }
 
 # Type-specific overrides — hardware/embedded projects have denser rules.
 _TYPE_THRESHOLD_OVERRIDES: dict[str, dict[str, int]] = {
     "fpga-rtl": {
-        "docs/governance/rules.md": 1000,
-        "docs/governance/workflow.md": 500,
-        "docs/governance/verification.md": 600,
+        "docs/governance/RULES.md": 1000,
+        "docs/governance/WORKFLOW.md": 500,
+        "docs/governance/VERIFICATION.md": 600,
     },
     "yocto-bsp": {
-        "docs/governance/rules.md": 1000,
-        "docs/governance/workflow.md": 500,
-        "docs/governance/verification.md": 500,
+        "docs/governance/RULES.md": 1000,
+        "docs/governance/WORKFLOW.md": 500,
+        "docs/governance/VERIFICATION.md": 500,
     },
     "embedded-hardware": {
-        "docs/governance/rules.md": 1000,
-        "docs/governance/verification.md": 500,
+        "docs/governance/RULES.md": 1000,
+        "docs/governance/VERIFICATION.md": 500,
     },
     "pcb-hardware": {
-        "docs/governance/rules.md": 900,
-        "docs/governance/verification.md": 500,
+        "docs/governance/RULES.md": 900,
+        "docs/governance/VERIFICATION.md": 500,
     },
 }
 
@@ -567,22 +569,22 @@ def run_auto_fix(root: Path, report: AuditReport) -> list[str]:
                     pass  # Best-effort
 
         # Fix missing recommended files
-        elif result.name == "recommended:docs/architecture.md" and not result.passed:
+        elif result.name == "recommended:docs/ARCHITECTURE.md" and not result.passed:
             from specsmith.architect import generate_architecture
 
             try:
                 generate_architecture(root)
-                fixed.append("Generated docs/architecture.md from project scan")
+                fixed.append("Generated docs/ARCHITECTURE.md from project scan")
             except Exception:  # noqa: BLE001
                 # Fallback stub
-                path = root / "docs" / "architecture.md"
+                path = root / "docs" / "ARCHITECTURE.md"
                 path.parent.mkdir(parents=True, exist_ok=True)
                 path.write_text(
                     f"# Architecture — {root.name}\n\n"
                     "[Run `specsmith architect` to populate]\n",
                     encoding="utf-8",
                 )
-                fixed.append("Created stub docs/architecture.md")
+                fixed.append("Created stub docs/ARCHITECTURE.md")
 
         elif result.name == "recommended:docs/REQUIREMENTS.md" and not result.passed:
             path = root / "docs" / "REQUIREMENTS.md"

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/cli.py

@@ -517,14 +517,14 @@ def import_project(project_dir: str, force: bool, guided: bool, dry_run: bool) -
             "LEDGER.md",
             "docs/REQUIREMENTS.md",
             "docs/TEST_SPEC.md",
-            "docs/architecture.md",
+            "docs/ARCHITECTURE.md",
             "scaffold.yml",
-            "docs/governance/rules.md",
-            "docs/governance/workflow.md",
-            "docs/governance/roles.md",
-            "docs/governance/context-budget.md",
-            "docs/governance/verification.md",
-            "docs/governance/drift-metrics.md",
+            "docs/governance/RULES.md",
+            "docs/governance/WORKFLOW.md",
+            "docs/governance/ROLES.md",
+            "docs/governance/CONTEXT-BUDGET.md",
+            "docs/governance/VERIFICATION.md",
+            "docs/governance/DRIFT-METRICS.md",
         ]
         for f in overlay_files:
             exists = (root / f).exists()

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/config.py

@@ -145,6 +145,18 @@ class ProjectConfig(BaseModel):
         default="", description="Test framework detected by import"
     )
 
+    # License
+    license: str = Field(
+        default="MIT",
+        description="SPDX license identifier (MIT, Apache-2.0, GPL-3.0-only, etc.)",
+    )
+
+    # Community files
+    community_files: list[str] = Field(
+        default=["contributing", "license", "security", "coc", "pr-template", "issue-templates"],
+        description="Community/compliance files to generate",
+    )
+
     # Agent integrations
     integrations: list[str] = Field(
         default=["agents-md"],

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/differ.py

@@ -13,12 +13,12 @@ from jinja2 import Environment, PackageLoader, select_autoescape
 from specsmith.config import ProjectConfig
 
 _GOVERNANCE_FILES: list[tuple[str, str]] = [
-    ("governance/rules.md.j2", "docs/governance/rules.md"),
-    ("governance/workflow.md.j2", "docs/governance/workflow.md"),
-    ("governance/roles.md.j2", "docs/governance/roles.md"),
-    ("governance/context-budget.md.j2", "docs/governance/context-budget.md"),
-    ("governance/verification.md.j2", "docs/governance/verification.md"),
-    ("governance/drift-metrics.md.j2", "docs/governance/drift-metrics.md"),
+    ("governance/rules.md.j2", "docs/governance/RULES.md"),
+    ("governance/workflow.md.j2", "docs/governance/WORKFLOW.md"),
+    ("governance/roles.md.j2", "docs/governance/ROLES.md"),
+    ("governance/context-budget.md.j2", "docs/governance/CONTEXT-BUDGET.md"),
+    ("governance/verification.md.j2", "docs/governance/VERIFICATION.md"),
+    ("governance/drift-metrics.md.j2", "docs/governance/DRIFT-METRICS.md"),
 ]
 
 

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/exporter.py

@@ -136,11 +136,11 @@ def run_export(root: Path) -> str:
         "scaffold.yml",
         "docs/REQUIREMENTS.md",
         "docs/TEST_SPEC.md",
-        "docs/architecture.md",
-        "docs/governance/rules.md",
-        "docs/governance/workflow.md",
-        "docs/governance/roles.md",
-        "docs/governance/verification.md",
+        "docs/ARCHITECTURE.md",
+        "docs/governance/RULES.md",
+        "docs/governance/WORKFLOW.md",
+        "docs/governance/ROLES.md",
+        "docs/governance/VERIFICATION.md",
     ]
     for gf in gov_files:
         exists = (root / gf).exists()

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/importer.py

@@ -275,7 +275,7 @@ def detect_project(root: Path) -> DetectionResult:
         "GEMINI.md",
         "docs/REQUIREMENTS.md",
         "docs/TEST_SPEC.md",
-        "docs/architecture.md",
+        "docs/ARCHITECTURE.md",
     ):
         if (root / gov_file).exists():
             result.existing_governance.append(gov_file)
@@ -1033,8 +1033,8 @@ def generate_overlay(
         _write("docs/TEST_SPEC.md", tests)
 
     # docs/architecture.md — skip if project has architecture doc anywhere under docs/
-    existing_arch = list(target.glob("docs/**/architecture*")) + list(
-        target.glob("docs/**/ARCHITECTURE*")
+    existing_arch = list(target.glob("docs/**/ARCHITECTURE*")) + list(
+        target.glob("docs/**/architecture*")
     )
     if not (existing_arch and not force):
         arch = (
@@ -1059,18 +1059,18 @@ def generate_overlay(
             arch += "## Language Distribution\n"
             for lang_name, count in sorted(result.languages.items(), key=lambda x: -x[1]):
                 arch += f"- {lang_name}: {count} files\n"
-        _write("docs/architecture.md", arch)
+        _write("docs/ARCHITECTURE.md", arch)
 
     # --- Modular governance files ---
     # If AGENTS.md exists and is rich, extract sections from it.
     # Otherwise use generic stubs.
     gov = _extract_governance_sections(target)
-    _write("docs/governance/rules.md", gov["rules"])
-    _write("docs/governance/workflow.md", gov["workflow"])
-    _write("docs/governance/roles.md", gov["roles"])
-    _write("docs/governance/context-budget.md", gov["context-budget"])
-    _write("docs/governance/verification.md", gov["verification"])
-    _write("docs/governance/drift-metrics.md", gov["drift-metrics"])
+    _write("docs/governance/RULES.md", gov["rules"])
+    _write("docs/governance/WORKFLOW.md", gov["workflow"])
+    _write("docs/governance/ROLES.md", gov["roles"])
+    _write("docs/governance/CONTEXT-BUDGET.md", gov["context-budget"])
+    _write("docs/governance/VERIFICATION.md", gov["verification"])
+    _write("docs/governance/DRIFT-METRICS.md", gov["drift-metrics"])
 
     # If existing AGENTS.md is oversized, back it up and replace with a hub.
     agents_path = target / "AGENTS.md"
@@ -1091,17 +1091,17 @@ def generate_overlay(
                 "## Governance File Registry\n\n"
                 "| File | Content | Load timing |\n"
                 "| ---- | ------- | ----------- |\n"
-                "| `docs/governance/rules.md` | Hard rules, stop conditions, "
+                "| `docs/governance/RULES.md` | Hard rules, stop conditions, "
                 "project-specific rules | Every session start |\n"
-                "| `docs/governance/workflow.md` | Session lifecycle, "
+                "| `docs/governance/WORKFLOW.md` | Session lifecycle, "
                 "save/push protocol | Every session start |\n"
-                "| `docs/governance/roles.md` | Agent role boundaries | "
+                "| `docs/governance/ROLES.md` | Agent role boundaries | "
                 "Every session start |\n"
-                "| `docs/governance/context-budget.md` | Context management | "
+                "| `docs/governance/CONTEXT-BUDGET.md` | Context management | "
                 "Every session start |\n"
-                "| `docs/governance/verification.md` | Verification, "
+                "| `docs/governance/VERIFICATION.md` | Verification, "
                 "consistency | When verifying |\n"
-                "| `docs/governance/drift-metrics.md` | Environment, "
+                "| `docs/governance/DRIFT-METRICS.md` | Environment, "
                 "platform | On audit |\n\n"
                 "Other project documents:\n\n"
                 "| File | Content |\n"
@@ -1109,7 +1109,7 @@ def generate_overlay(
                 "| `LEDGER.md` | Append-only work record |\n"
                 "| `docs/REQUIREMENTS.md` | Formal requirements |\n"
                 "| `docs/TEST_SPEC.md` | Test cases |\n"
-                "| `docs/architecture.md` | Architecture |\n\n"
+                "| `docs/ARCHITECTURE.md` | Architecture |\n\n"
                 "---\n\n"
                 f"*Original AGENTS.md ({agents_lines} lines) backed up "
                 "to AGENTS.md.bak. Content extracted into modular "
@@ -1126,6 +1126,21 @@ def generate_overlay(
         save_budget(target, CreditBudget())  # unlimited by default
         created.append(target / ".specsmith" / "credit-budget.json")
 
+    # --- Community files (only create if missing) ---
+    _write(
+        "CONTRIBUTING.md",
+        f"# Contributing to {name}\n\n"
+        "See `AGENTS.md` for governance and `LEDGER.md` for session state.\n\n"
+        "## Workflow\n"
+        "All changes follow: propose \u2192 check \u2192 execute \u2192 verify \u2192 record.\n",
+    )
+    _write(
+        "SECURITY.md",
+        f"# Security Policy\n\n"
+        f"To report a vulnerability in {name}, please use the repository's "
+        "private vulnerability reporting feature. Do not open a public issue.\n",
+    )
+
     # --- CI config (merge: only create if no CI detected) ---
     if not result.existing_ci and result.vcs_platform:
         try:

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/aider.py

@@ -34,5 +34,5 @@ class AiderAdapter(AgentAdapter):
             f"read:\n"
             f"  - AGENTS.md\n"
             f"  - LEDGER.md\n"
-            f"  - docs/governance/rules.md\n"
+            f"  - docs/governance/RULES.md\n"
         )

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/claude_code.py

@@ -48,7 +48,7 @@ Project type: {config.type_label}. Description: {config.description or "See READ
 ## Start here
 1. Read `AGENTS.md` for project identity, governance hub, and file registry
 2. Read `LEDGER.md` for session state and open TODOs
-3. Read `docs/governance/rules.md` for hard rules
+3. Read `docs/governance/RULES.md` for hard rules
 
 ## Workflow
 All changes follow: propose → check → execute → verify → record.

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/cursor.py

@@ -49,7 +49,7 @@ Project type: {config.type_label} (Section {config.section_ref}).
 ## Required reading
 1. `AGENTS.md` — governance hub
 2. `LEDGER.md` — session state
-3. `docs/governance/rules.md` — hard rules
+3. `docs/governance/RULES.md` — hard rules
 
 ## Workflow
 All changes: propose → check → execute → verify → record.

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/gemini.py

@@ -40,7 +40,7 @@ class GeminiAdapter(AgentAdapter):
             f"## Required reading\n"
             f"1. `AGENTS.md` — governance hub\n"
             f"2. `LEDGER.md` — session state and open TODOs\n"
-            f"3. `docs/governance/rules.md` — hard rules and stop conditions\n\n"
+            f"3. `docs/governance/RULES.md` \u2014 hard rules and stop conditions\n\n"
             f"## Constraints\n"
             f"- Keep AGENTS.md under 200 lines\n"
             f"- All agent-invoked commands must have timeouts\n"

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/warp.py

@@ -53,7 +53,7 @@ Description: {config.description or "See README.md"}.
 ## Session Start
 1. Read `AGENTS.md` — the governance hub
 2. Read `LEDGER.md` — check last session state and open TODOs
-3. Read `docs/governance/rules.md` — hard rules and stop conditions
+3. Read `docs/governance/RULES.md` — hard rules and stop conditions
 
 ## Workflow
 All changes follow: **propose → check → execute → verify → record**.
@@ -67,7 +67,7 @@ All changes follow: **propose → check → execute → verify → record**.
 - `docs/governance/` — modular governance docs (load on demand)
 - `docs/REQUIREMENTS.md` — formal requirements
 - `docs/TEST_SPEC.md` — test specifications
-- `docs/architecture.md` — system architecture
+- `docs/ARCHITECTURE.md` — system architecture
 
 ## Session Start
 Before any work, run: `specsmith update --check --project-dir .`

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/integrations/windsurf.py

@@ -35,7 +35,7 @@ class WindsurfAdapter(AgentAdapter):
             f"## Required reading\n"
             f"1. Read `AGENTS.md` — governance hub\n"
             f"2. Read `LEDGER.md` — session state\n"
-            f"3. Read `docs/governance/rules.md` — hard rules\n\n"
+            f"3. Read `docs/governance/RULES.md` \u2014 hard rules\n\n"
             f"## Workflow\n"
             f"All changes: propose → check → execute → verify → record.\n\n"
             f"## Constraints\n"

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/scaffolder.py

@@ -108,15 +108,15 @@ def _build_file_map(config: ProjectConfig) -> list[tuple[str, str]]:
         ("gitattributes.j2", ".gitattributes"),
         ("editorconfig.j2", ".editorconfig"),
         # Modular governance
-        ("governance/rules.md.j2", "docs/governance/rules.md"),
-        ("governance/workflow.md.j2", "docs/governance/workflow.md"),
-        ("governance/roles.md.j2", "docs/governance/roles.md"),
-        ("governance/context-budget.md.j2", "docs/governance/context-budget.md"),
-        ("governance/verification.md.j2", "docs/governance/verification.md"),
-        ("governance/drift-metrics.md.j2", "docs/governance/drift-metrics.md"),
+        ("governance/rules.md.j2", "docs/governance/RULES.md"),
+        ("governance/workflow.md.j2", "docs/governance/WORKFLOW.md"),
+        ("governance/roles.md.j2", "docs/governance/ROLES.md"),
+        ("governance/context-budget.md.j2", "docs/governance/CONTEXT-BUDGET.md"),
+        ("governance/verification.md.j2", "docs/governance/VERIFICATION.md"),
+        ("governance/drift-metrics.md.j2", "docs/governance/DRIFT-METRICS.md"),
         # Project docs
-        ("docs/architecture.md.j2", "docs/architecture.md"),
-        ("docs/workflow.md.j2", "docs/workflow.md"),
+        ("docs/architecture.md.j2", "docs/ARCHITECTURE.md"),
+        ("docs/workflow.md.j2", "docs/WORKFLOW.md"),
         ("docs/requirements.md.j2", "docs/REQUIREMENTS.md"),
         ("docs/test-spec.md.j2", "docs/TEST_SPEC.md"),
         # Scripts
@@ -134,6 +134,9 @@ def _build_file_map(config: ProjectConfig) -> list[tuple[str, str]]:
             ]
         )
 
+    # Community / compliance files
+    files.extend(_build_community_files(config))
+
     # Python project types get pyproject.toml and src layout
     if config.type in (
         ProjectType.CLI_PYTHON,
@@ -375,5 +378,48 @@ def _get_empty_dirs(config: ProjectConfig, target: Path) -> list[Path]:
     return dirs
 
 
+# License template mapping: SPDX ID → template filename
+_LICENSE_TEMPLATES: dict[str, str] = {
+    "MIT": "community/license-MIT.j2",
+    "Apache-2.0": "community/license-Apache-2.0.j2",
+}
+
+
+def _build_community_files(config: ProjectConfig) -> list[tuple[str, str]]:
+    """Build community/compliance file map based on config.community_files."""
+    files: list[tuple[str, str]] = []
+    cf = set(config.community_files)
+
+    if "contributing" in cf:
+        files.append(("community/contributing.md.j2", "CONTRIBUTING.md"))
+
+    if "license" in cf:
+        tmpl = _LICENSE_TEMPLATES.get(config.license)
+        if tmpl:
+            files.append((tmpl, "LICENSE"))
+        # Unsupported license → skip (user provides their own)
+
+    if "security" in cf:
+        files.append(("community/security.md.j2", "SECURITY.md"))
+
+    if "coc" in cf:
+        files.append(("community/code_of_conduct.md.j2", "CODE_OF_CONDUCT.md"))
+
+    if "pr-template" in cf and config.vcs_platform == "github":
+        files.append(
+            ("community/pull_request_template.md.j2", ".github/PULL_REQUEST_TEMPLATE.md")
+        )
+
+    if "issue-templates" in cf and config.vcs_platform == "github":
+        files.extend(
+            [
+                ("community/bug_report.md.j2", ".github/ISSUE_TEMPLATE/bug_report.md"),
+                ("community/feature_request.md.j2", ".github/ISSUE_TEMPLATE/feature_request.md"),
+            ]
+        )
+
+    return files
+
+
 def _init_commands(config: ProjectConfig) -> None:
     """Placeholder for src/specsmith/commands/__init__.py."""

{specsmith-0.1.4.dev35 → specsmith-0.1.4.dev37}/src/specsmith/templates/agents.md.j2

@@ -13,12 +13,12 @@ This project uses the modular governance layout. Read this file in full on every
 
 | File | Content | Load timing |
 | ---- | ------- | ----------- |
-| `docs/governance/rules.md` | Hard rules H1–H9, stop conditions | Every session start |
-| `docs/governance/workflow.md` | Session lifecycle, proposal format, ledger format | Every session start |
-| `docs/governance/roles.md` | Agent role boundaries, behavioral rules | Every session start |
-| `docs/governance/context-budget.md` | Context management, credit optimization | Every session start |
-| `docs/governance/verification.md` | Verification standards, acceptance criteria | When performing verification |
-| `docs/governance/drift-metrics.md` | Drift detection, feedback loops, health signals | On `audit` or session start |
+| `docs/governance/RULES.md` | Hard rules H1–H9, stop conditions | Every session start |
+| `docs/governance/WORKFLOW.md` | Session lifecycle, proposal format, ledger format | Every session start |
+| `docs/governance/ROLES.md` | Agent role boundaries, behavioral rules | Every session start |
+| `docs/governance/CONTEXT-BUDGET.md` | Context management, credit optimization | Every session start |
+| `docs/governance/VERIFICATION.md` | Verification standards, acceptance criteria | When performing verification |
+| `docs/governance/DRIFT-METRICS.md` | Drift detection, feedback loops, health signals | On `audit` or session start |
 
 Other project documents:
 
@@ -26,8 +26,8 @@ Other project documents:
 | ---- | ------- |
 | `README.md` | Project overview, structure, goals, status |
 | `LEDGER.md` | Append-only work record (sole authority for session state) |
-| `docs/architecture.md` | Components, boundaries, interfaces, platform expectations |
-| `docs/workflow.md` | Work loop, milestones, PR expectations |
+| `docs/ARCHITECTURE.md` | Components, boundaries, interfaces, platform expectations |
+| `docs/WORKFLOW.md` | Work loop, milestones, PR expectations |
 | `docs/REQUIREMENTS.md` | Formal, numbered, testable requirements |
 | `docs/TEST_SPEC.md` | Test cases linked to requirements |
 
@@ -38,10 +38,10 @@ Other project documents:
 1. **AGENTS.md + docs/governance/*** — highest (governance docs inherit this file's authority)
 2. **README.md** — project intent and scope
 3. **docs/REQUIREMENTS.md** — what the system must do
-4. **docs/architecture.md** — how the system is structured
+4. **docs/ARCHITECTURE.md** — how the system is structured
 5. **docs/TEST_SPEC.md** — how the system is verified
 6. **LEDGER.md** — sole authority for session state
-7. **docs/workflow.md** — how work proceeds
+7. **docs/WORKFLOW.md** — how work proceeds
 
 ---