archspec 1.0.2 → 1.1.0

package/index.js

@@ -12,12 +12,15 @@ if (command === "init") {
 }
 
 function init() {
-  createFolder("architecture");
-  createFolder("governance");
-  createFolder("implementation");
-  createFolder("execution");
+  createFolderWithFiles("architecture", architectureTemplates);
+  console.log("Architecture folder initialized.");
 
-  console.log("Governance structure initialized.");
+  // createFolder("architecture");
+  // createFolder("governance");
+  // createFolder("implementation");
+  // createFolder("execution");
+
+  // console.log("Governance structure initialized.");
 }
 
 function createFolder(name) {
@@ -30,3 +33,201 @@ function createFolder(name) {
     console.log(`Folder already exists: ${name}`);
   }
 }
+
+const architectureTemplates = {
+  "README.md": `# Architecture Governance
+
+This directory defines how architecture is created and maintained.
+
+## Source of Truth
+- \`architecture.decisions.md\` is the ONLY source of truth.
+- \`architecture.md\` is a GENERATED artifact and must never be edited manually.
+
+## Core Rules
+1. All architectural changes are expressed as Decisions.
+2. Each Decision belongs to exactly ONE layer.
+3. Only Decisions with \`Status: approved\` are applied.
+4. Agents may NOT edit \`architecture.md\`.
+5. \`architecture.md\` can be deleted and regenerated at any time.
+
+## Layers (Fixed)
+The system uses a bottom-up, layered architecture:
+
+1. Infra
+2. DAL
+3. Services
+4. Controllers
+5. Routes
+6. API Service
+7. FE Services
+8. Context
+9. Components
+
+These layers are fixed and must not be renamed or reordered.
+
+## Workflow
+1. Layer agent proposes a Decision (\`Status: proposed\`)
+2. Human reviews and approves the Decision
+3. Writer agent regenerates \`architecture.md\` from decisions
+
+If it is not a Decision, it is not architecture.
+
+## Operation
+
+For daily usage and workflow, see:
+
+- \`flow.md\` – Implementation decision lifecycle
+- \`agent-prompts.md\` – Agent definitions
+- \`init.md\` – Initial setup instructions
+`,
+
+  "flow.md": `## The daily workflow (this is the loop)
+
+### Step A – Propose
+
+* Run a **layer agent**
+* It appends a \`Status: proposed\` decision to \`architecture.decisions.md\`
+
+### Step B – Validate
+
+* Run **Architect Agent**
+* Fix or clarify decision if blocked
+
+### Step C – Approve (YOU)
+
+* Change **one word**:
+
+  Status: approved
+
+### Step D – Generate
+
+* Run **Writer Agent**
+* \`architecture.md\` is regenerated fully
+
+That’s it.
+
+---
+
+## Hard rules (do not break these)
+
+* ❌ No agent edits \`architecture.md\`
+* ❌ No decision spans multiple layers
+* ❌ No prose inside decisions
+* ❌ No incremental edits to architecture.md
+* ✅ Delete + regenerate is always safe
+
+If these rules hold → system is deterministic.
+
+---
+
+## Mental model (for Cursor usage)
+
+* \`architecture.decisions.md\` = config
+* Writer agent = compiler
+* \`architecture.md\` = build artifact
+* You = approver of intent
+* Cursor = execution environment
+
+---
+
+### Final checkpoint
+
+If you can:
+
+* delete \`architecture.md\`
+* regenerate it
+* get the same result
+
+✅ You’ve set it up correctly.
+`,
+
+  "init.md": `# Cursor Setup: Deterministic Bottom-Up Architecture
+
+## 1. Create the files (once)
+
+/architecture
+  ├─ architecture.decisions.md   ← ONLY editable truth
+  ├─ architecture.md             ← GENERATED, read-only
+  └─ README.md                   ← rules 
+
+## 2. Initialize architecture.decisions.md
+
+Paste this exactly:
+
+# Architecture Decisions
+
+## Rules
+- Decisions are the ONLY source of truth
+- architecture.md is generated, never edited
+- Every decision belongs to exactly ONE layer
+- Only decisions with Status: approved are applied
+
+## Layers (fixed)
+- Infra
+- DAL
+- Services
+- Controllers
+- Routes
+- API Service
+- FE Services
+- Context
+- Components
+`,
+
+  "agents-prompts.md": `# Architecture Agent Prompts
+
+This document defines the exact prompts used to operate the architecture system in this repository.
+
+These prompts are part of the architecture governance.
+They must remain stable and should not be casually modified.
+
+(Full prompt templates should be pasted here.)
+`,
+
+  "architecture.decisions.md": `# Architecture Decisions
+
+## Rules
+- Decisions are the ONLY source of truth
+- architecture.md is generated, never edited
+- Every decision belongs to exactly ONE layer
+- Only decisions with Status: approved are applied
+
+## Layers (fixed)
+- Infra
+- DAL
+- Services
+- Controllers
+- Routes
+- API Service
+- FE Services
+- Context
+- Components
+
+---
+
+## Infra
+
+## DAL
+
+## Services
+
+## Controllers
+
+## Routes
+
+## API Service
+
+## FE Services
+
+## Context
+
+## Components
+`,
+
+  "architecture.md": `<!-- GENERATED FILE – DO NOT EDIT -->
+
+# Architecture
+
+This file is generated from architecture.decisions.md
+`
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archspec",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Architecture governance scaffolding CLI for structured project execution.",
   "bin": {
     "archspec": "./index.js"