@atlashub/smartstack-cli 4.41.0 → 4.43.0

package/templates/skills/{derive-prd → business-analyse-handoff}/steps/step-02-export.md

@@ -10,8 +10,8 @@ model: sonnet
 
 ## MANDATORY EXECUTION RULES
 
-- **ALWAYS** generate PRD via `ss derive-prd` CLI command (deterministic, never LLM)
-- **ALWAYS** verify PRD structure: $version=3.0.0, implementation.filesToCreate, 8 categories
+- **ALWAYS** generate PRD via `ss business-analyse-handoff` CLI command (deterministic, never LLM)
+- **ALWAYS** verify PRD structure: $version=3.0.0 or 4.0.0, implementation.filesToCreate (v3) or expectedFiles (v4), 8 categories
 - **ALWAYS** verify file counts match between PRD and handoff
 - **ALWAYS** generate progress.txt from template
 - **ALWAYS** update BA manifest (docs/index.json)
@@ -33,47 +33,60 @@ For EACH module:
 
 ```bash
 # Single module:
-ss derive-prd --ba-dir {moduleBaDir} --output .ralph/prd-{moduleCode}.json
+ss business-analyse-handoff --ba-dir {moduleBaDir} --output .ralph/prd-{moduleCode}.json
 
 # All modules from app-level index.json:
-ss derive-prd --ba-app {appIndexPath}
+ss business-analyse-handoff --ba-app {appIndexPath}
 ```
 
 **Option B — Legacy feature.json:**
 
 ```bash
-ss derive-prd --feature {moduleFeaturePath} --output .ralph/prd-{moduleCode}.json
+ss business-analyse-handoff --feature {moduleFeaturePath} --output .ralph/prd-{moduleCode}.json
 ```
 
+**Option C — v4 spec-oriented PRD (1M context + compaction):**
+
+```bash
+ss business-analyse-handoff --ba-app {appIndexPath} --v4
+```
+
+Generates `prd-{moduleCode}.json` with `$version: "4.0.0"` containing:
+- `objectives[]` with acceptance criteria (instead of pre-computed tasks)
+- `expectedFiles` (same 8 categories, for file reconciliation)
+- `gates` (declarative quality gate definitions)
+- Architecture, business rules, BR mapping, seed data (same as v3)
+
 ### 2. POST-CHECK PRD (BLOCKING)
 
-> **Reference:** Read `references/prd-generation.md` for complete validation rules.
+> **Reference:** See loaded context `prd-generation.md` for complete validation rules.
 
 ```javascript
 const prd = readJSON(`.ralph/prd-${moduleCode}.json`);
 const featureHandoff = moduleFeature.handoff.filesToCreate;
 
 // Check 1: Version
-if (prd.$version !== "3.0.0") {
-  BLOCKING_ERROR("PRD version must be 3.0.0, got: " + prd.$version);
+if (prd.$version !== "3.0.0" && prd.$version !== "4.0.0") {
+  BLOCKING_ERROR("PRD version must be 3.0.0 or 4.0.0, got: " + prd.$version);
 }
 
-// Check 2: filesToCreate under implementation (not root)
-if (prd.filesToCreate && !prd.implementation?.filesToCreate) {
-  BLOCKING_ERROR("prd.json has filesToCreate at ROOT — not from ss derive-prd");
+// Check 2: filesToCreate location (v3: implementation.filesToCreate, v4: expectedFiles)
+const ftc = prd.$version === "4.0.0" ? prd.expectedFiles : prd.implementation?.filesToCreate;
+if (!ftc) {
+  BLOCKING_ERROR("prd.json missing file manifest (v3: implementation.filesToCreate, v4: expectedFiles)");
   STOP;
 }
 
 // Check 3: All 8 categories present
 const categories = ['domain', 'application', 'infrastructure', 'api', 'frontend', 'seedData', 'tests', 'documentation'];
-const missingCategories = categories.filter(cat => !prd.implementation.filesToCreate[cat]);
+const missingCategories = categories.filter(cat => !ftc[cat]);
 if (missingCategories.length > 0) {
   BLOCKING_ERROR("Missing categories: " + missingCategories.join(', '));
 }
 
 // Check 4: File counts match
 for (const cat of categories) {
-  const prdCount = prd.implementation.filesToCreate[cat]?.length ?? 0;
+  const prdCount = ftc[cat]?.length ?? 0;
   const featureCount = featureHandoff[cat]?.length ?? 0;
   if (prdCount !== featureCount) {
     BLOCKING_ERROR(`${cat}: prd=${prdCount} but feature=${featureCount}`);
@@ -100,7 +113,7 @@ Write to: `.ralph/modules-queue.json`
 
 ### 4. Generate progress.txt
 
-> **Template:** Read `templates/tpl-progress.md` for complete structure.
+> **Template:** See loaded context `tpl-progress.md` for complete structure.
 > **Data source:** Populate with module-specific data from index.json.
 
 - One section per module in topological order
@@ -111,6 +124,13 @@ Write to: `.ralph/modules-queue.json`
 - Summary with totals across all modules
 - Cross-module tasks IF multi-module
 
+Before writing:
+```
+IF .ralph/progress.txt exists AND contains "Iteration" entries:
+  WARN: "progress.txt contains development progress — appending handoff section instead of overwriting"
+  APPEND instead of WRITE
+```
+
 Write to: `.ralph/progress.txt`
 
 ### 5. Update BA Manifest (docs/index.json)
@@ -172,7 +192,7 @@ Artifacts generated:
   docs/index.json               — BA manifest (status: handed-off)
 
 [NEXT] Development:
-  1. Run /ralph-loop to begin implementation
+  1. Run /business-analyse-develop to begin implementation
   2. Modules will be processed in topological order
   3. Each module PRD contains {total_files} files across 8 categories
 
@@ -187,7 +207,7 @@ Artifacts generated:
 2. `.ralph/progress.txt` exists (>500 bytes)
 3. `.ralph/modules-queue.json` exists (if 2+ modules)
 4. `docs/index.json` updated with correct entry count and status "handed-off"
-5. All PRD files have $version=3.0.0, implementation.filesToCreate, 8 categories
+5. All PRD files have $version=3.0.0 or 4.0.0, file manifest present, 8 categories
 6. File counts match between PRD and handoff for all categories
 
 **IF any check fails -> fix before completing.**

package/templates/skills/{ba-generate-html → business-analyse-html}/SKILL.md

@@ -1,19 +1,19 @@
 ---
-name: ba-generate-html
+name: business-analyse-html
 description: "Generate the interactive HTML document from business analysis JSON data"
 model: opus
 user_invocable: true
 ---
 
-# /ba-generate-html
+# /business-analyse-html
 
 Generate the interactive HTML document of the business analysis from the JSON analysis files.
 
 ## Triggers
 
-- Explicit invocation: `/ba-generate-html <feature-id>`
+- Explicit invocation: `/business-analyse-html <feature-id>`
 - After `/business-analyse` step-04 (consolidation complete)
-- Delegation from `/ba-review` (after review corrections applied)
+- Delegation from `/business-analyse-review` (after review corrections applied)
 
 ## Parameters