@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/business-analyse-develop/steps/step-02-execute.md

@@ -1,216 +0,0 @@
----
-name: step-02-execute
-description: Delegate module execution to /apex
-next_step: steps/step-03-commit.md
----
-
-# Step 2: Delegate to /apex
-
-> **REMINDER:** Ralph NEVER pauses. Execute ALL steps through completion. Stopping to ask = VIOLATION.
-
-> **CONTEXT OPTIMIZATION:** Read ONCE (first iteration). Subsequent iterations use compact-loop.md.
-
-## YOUR TASK:
-
-Delegate the current module's tasks to `/apex -d` for code generation. Ralph handles orchestration only.
-
-**ULTRA THINK about the delegation context.**
-
----
-
-## EXECUTION RULES:
-
-1. **VERIFY DEPENDENCIES** — All task dependencies must be completed
-2. **DELEGATE TO /apex** — All code generation via `/apex -d`
-3. **TRACK RESULTS** — Verify PRD state after apex returns
-4. **NEVER GENERATE CODE** — Ralph orchestrates, apex generates
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Verify Dependencies
-
-```javascript
-// PRD PATH RESOLUTION
-const queuePath = '.ralph/modules-queue.json';
-let currentPrdPath = '.ralph/prd.json';
-if (fileExists(queuePath)) {
-  const queue = readJSON(queuePath);
-  currentPrdPath = queue.modules[queue.currentIndex].prdFile;
-}
-
-const prd = readJSON(currentPrdPath);
-const task = prd.tasks.find(t => t.id === {current_task_id});
-for (const depId of task.dependencies) {
-  const dep = prd.tasks.find(t => t.id === depId);
-  if (!dep || dep.status !== 'completed') {
-    task.status = 'blocked'; task.error = `Dependency ${depId} not completed`;
-    writeJSON(currentPrdPath, prd);
-    STOP — return to step-01
-  }
-}
-```
-
-### 2. Mark In-Progress
-
-```javascript
-task.status = 'in_progress';
-task.started_at = new Date().toISOString();
-writeJSON(currentPrdPath, prd);
-```
-
-### 3. Delegate to /apex
-
-#### 3a. Parallel Mode (if `-p` flag)
-
-See `references/parallel-execution.md` for complete parallel protocol:
-
-**IF `{parallel_mode}` == true:**
-
-1. Phase 0 (Ralph sequential): Generate ALL entities from ALL modules + ONE migration
-2. Phase 1-N (Teams parallel): Spawn teammates per application/module for services/controllers/frontend/tests
-3. Collect results from teammates
-4. Cleanup team, proceed to step-03
-
-**ELSE (not parallel mode):**
-
-Continue with section-split mode or standard mode below.
-
-#### 3a+. State Persistence (before delegation)
-
-```javascript
-// Write state BEFORE delegating to apex so position survives context compression
-writeJSON('.ralph/ralph-state.json', {
-  currentStep: 'step-02-execute',
-  nextStep: 'step-03-commit',
-  currentModule: {current_module},
-  phase: 'apex-delegating',
-  timestamp: new Date().toISOString()
-});
-```
-
-#### 3b. Section-Split Mode
-
-```javascript
-if (prd._sectionSplit?.enabled) {
-  // Find next pending phase with dependencies met
-  const nextPhase = prd._sectionSplit.phases.find(p => p.status === 'pending');
-
-  if (!nextPhase) {
-    // All phases done — skip to step-04 completion check
-    goto STEP_04;
-  }
-
-  const depsOk = nextPhase.dependsOn.every(depIdx =>
-    prd._sectionSplit.phases[depIdx].status === 'completed'
-  );
-
-  if (!depsOk) {
-    console.warn(`Phase ${nextPhase.phase} blocked — dependencies incomplete`);
-    goto STEP_04;
-  }
-
-  const phaseLabel = nextPhase.type === 'foundation'
-    ? 'Phase 0: Foundation (all entities + migration + module seed data)'
-    : `Phase ${nextPhase.phase}: Section "${nextPhase.sectionCode}" (services + controllers + pages + tests)`;
-  console.log(`SECTION SPLIT: ${phaseLabel}`);
-
-  // ↓ MANDATORY: invoke apex now (not pseudo-code — execute this skill call)
-```
-
-**INVOKE `/apex -d {nextPhase.prdFile}`**
-
-Apex sees a focused (smaller) PRD covering only this phase's scope and executes normally.
-After apex returns: merge results into master PRD.
-Read `references/section-splitting.md` sections 7-9 for execution, merging, and failure handling.
-
-```javascript
-
-  nextPhase.status = 'completed';
-  prd._sectionSplit.currentPhase = nextPhase.phase;
-  writeJSON(currentPrdPath, prd);
-
-  // Continue to step-03 (commit), then step-04 loops back for next phase
-}
-```
-
-> See `references/section-splitting.md` for full detection, mapping, PRD construction, and merge logic.
-
-#### 3c. Standard Mode (no split, no parallel)
-
-**INVOKE `/apex -d {currentPrdPath}`**
-
-This delegates ALL remaining tasks for the current module to apex:
-
-- Apex reads the PRD, extracts context (`app_name`, `module_code`, `entities`, `sections`)
-- Apex executes ALL layers: domain → infrastructure → migration → application → api → seed data → frontend → tests
-- Apex runs full POST-CHECKs (50 checks from `references/post-checks.md`)
-- Apex commits per layer (atomic commits)
-- Apex validates with MCP (`validate_conventions`)
-- Apex updates task statuses in the PRD file directly
-
-> **FLAGS:** `-d` implies `-a` (auto, no user confirmation) and `-e` (economy, no nested teams).
-> Ralph manages parallelism via team orchestration, not apex.
-
-### 4. Verify Post-Apex Results
-
-```javascript
-// Re-read PRD after apex execution
-const updatedPrd = readJSON(currentPrdPath);
-const moduleTasks = updatedPrd.tasks.filter(t => t.module === {current_module});
-
-const completed = moduleTasks.filter(t => t.status === 'completed').length;
-const failed = moduleTasks.filter(t => t.status === 'failed').length;
-const pending = moduleTasks.filter(t => t.status === 'pending').length;
-
-if (failed > 0) {
-  console.log(`WARNING: ${failed} tasks failed — WILL BE RETRIED IMMEDIATELY in compact loop (next iteration)`);
-}
-
-if (pending > 0) {
-  console.log(`INFO: ${pending} tasks pending — WILL BE PROCESSED IMMEDIATELY in compact loop (next iteration)`);
-}
-
-console.log(`Apex completed: ${completed}/${moduleTasks.length} tasks`);
-```
-
-### 5. Update Progress
-
-```javascript
-// Append to progress file
-const progressEntry = `
-[Iteration ${prd.config.current_iteration}] Delegated to /apex
-  Module: ${prd.project.module}
-  Completed: ${completed}/${moduleTasks.length}
-  Failed: ${failed}
-  Pending: ${pending}
-`;
-appendFile('.ralph/progress.txt', progressEntry);
-```
-
----
-
-## TRANSITION RULE (ABSOLUTE — NO EXCEPTIONS)
-
-+==============================================================================+
-|  AFTER APEX RETURNS, YOU MUST IMMEDIATELY PROCEED TO STEP 03.               |
-|  DO NOT pause. DO NOT summarize. DO NOT ask the user.                       |
-|  DO NOT display a progress report and wait.                                  |
-|  Regardless of task failures, pending items, or scope size:                 |
-|  -> LOG the status (section 4-5 above)                                      |
-|  -> IMMEDIATELY load step-03-commit.md                                      |
-|  Any other behavior = EXECUTION GUARANTEE VIOLATION.                        |
-+==============================================================================+
-
-## CONSTRAINTS:
-
-- **DO:** Delegate to apex, verify results, maintain PRD state
-- **DON'T:** Generate code directly, run inline POST-CHECKs, invoke MCP tools for generation
-- **DON'T:** Stop to ask the user anything — fully autonomous
-
----
-
-## NEXT STEP:
-
-IMMEDIATELY proceed to `./step-03-commit.md` — NO PAUSE.

package/templates/skills/business-analyse-develop/steps/step-02-v4-verify.md

@@ -1,176 +0,0 @@
----
-name: step-02-v4-verify
-description: Final verification gates, file reconciliation, BR coverage, and report generation
-model: opus
----
-
-# Step 02-v4: Verify + Report
-
-## YOUR TASK
-
-After ALL modules are implemented, run final verification across the ENTIRE project, then generate the completion report.
-
----
-
-## VERSION GUARD
-
-```javascript
-// This step is ONLY for v4 PRDs. If a v3 PRD reaches here, route back to step-05-report.md.
-const prd = readJSON(currentPrdPath);
-if (prd.$version !== '4.0.0') {
-  console.error(`step-02-v4-verify loaded with $version=${prd.$version} — expected 4.0.0`);
-  console.log('Routing to step-05-report.md (v3 report generation)');
-  // → Load steps/step-05-report.md instead
-  return;
-}
-```
-
-## FINAL VERIFICATION SEQUENCE
-
-### 1. Full Solution Build
-
-```bash
-dotnet build 2>&1
-```
-
-This catches cross-module compilation issues that per-module builds might miss.
-
-### 2. Full Test Suite
-
-```bash
-dotnet test 2>&1
-```
-
-Run ALL tests across ALL modules. This catches cross-module integration issues.
-
-### 3. Frontend Verification
-
-```bash
-npm run typecheck 2>&1
-npm test -- --run 2>&1
-```
-
-### 4. File Reconciliation
-
-For each module's PRD, compare expected files against actual files on disk:
-
-```javascript
-// v4 uses prd.expectedFiles, v3 uses prd.implementation.filesToCreate (guard: should be v4 here)
-const fileManifest = prd.expectedFiles || prd.implementation?.filesToCreate;
-if (!fileManifest) {
-  console.error('BLOCKING: PRD has no file manifest (neither expectedFiles nor implementation.filesToCreate)');
-  STOP;
-}
-
-for (const category of ['domain', 'application', 'infrastructure', 'api', 'frontend', 'seedData', 'tests', 'documentation']) {
-  const expected = fileManifest[category] || [];
-  for (const file of expected) {
-    if (!existsOnDisk(file.path)) {
-      MISSING.push({ category, path: file.path, type: file.type });
-    }
-  }
-}
-```
-
-**If missing files found:**
-- List them clearly with category and expected path
-- Delegate to `/apex`: "Create missing files: {list}"
-- Re-verify after creation
-
-### 5. Business Rule Coverage
-
-For each BR in ALL modules' `brToCodeMapping`:
-1. Verify target file exists
-2. Verify implementation is present (grep for method/class name)
-3. Verify test coverage (grep test files for BR reference)
-
-Output:
-```
-BR Coverage: {covered}/{total} ({pct}%)
-Missing: BR-VAL-INV-003 (no test), BR-CALC-INV-005 (no implementation)
-```
-
-**If coverage < 100%:** Delegate remediation to `/apex`.
-
-### 6. MCP Final Scan
-
-```javascript
-// Security validation (BLOCKING)
-mcp__smartstack__validate_security({ projectPath: "." })
-
-// Convention validation (report)
-mcp__smartstack__validate_conventions({ projectPath: "." })
-
-// Code review — semantic permission check (BLOCKING if write endpoint has Read permission)
-mcp__smartstack__review_code({ files: changedFiles, focus: "security" })
-
-// Test convention validation (report)
-mcp__smartstack__validate_test_conventions({ projectPath: "." })
-```
-
-Log results. Security and permission mismatches are BLOCKING. Convention/test findings go in the report.
-
----
-
-## REPORT GENERATION
-
-Generate `.ralph/reports/{feature}.md`:
-
-```markdown
-# Feature Report: {applicationName}
-
-**Generated:** {date}
-**Modules:** {moduleCount}
-**Duration:** {startTime} → {endTime}
-
-## Summary
-
-| Module | Entities | BRs | Sections | Build | Tests | Coverage |
-|--------|----------|-----|----------|-------|-------|----------|
-| {mod1} | {n}      | {n} | {n}      | PASS  | PASS  | {pct}%   |
-| {mod2} | {n}      | {n} | {n}      | PASS  | PASS  | {pct}%   |
-
-## Objectives
-
-| Objective | Status | Acceptance Criteria |
-|-----------|--------|---------------------|
-| {obj.description} | PASS/FAIL | {criteria results} |
-
-## File Reconciliation
-
-| Category | Expected | Present | Missing |
-|----------|----------|---------|---------|
-| domain | {n} | {n} | {list} |
-| ... | | | |
-
-## Business Rule Coverage
-
-| BR ID | Name | Implementation | Test | Status |
-|-------|------|----------------|------|--------|
-| {id} | {name} | {file}:{method} | {testFile} | PASS/FAIL |
-
-## Quality Gates
-
-| Gate | Result |
-|------|--------|
-| dotnet build | PASS |
-| dotnet test | PASS ({n} tests) |
-| npm typecheck | PASS |
-| npm test | PASS ({n} tests) |
-| MCP security | {findings} |
-| MCP conventions | {findings} |
-
-## Git Commits
-
-{list of commits with hashes and messages}
-```
-
----
-
-## COMPLETION
-
-After report is generated:
-1. Display report path: `.ralph/reports/{feature}.md`
-2. Display summary stats
-3. If completion_promise was set: output the promise text
-4. Ralph-Loop is DONE

package/templates/skills/business-analyse-develop/steps/step-03-commit.md

@@ -1,107 +0,0 @@
----
-name: step-03-commit
-description: Commit PRD state after apex delegation
-next_step: steps/step-04-check.md
----
-
-# Step 3: Commit PRD State
-
-> **REMINDER:** Ralph NEVER pauses. Execute ALL steps through completion. Stopping to ask = VIOLATION.
-
-> **CONTEXT OPTIMIZATION:** Read ONCE (first iteration). Subsequent iterations use compact-loop.md.
-
-## YOUR TASK:
-
-Commit PRD state changes after apex delegation. Apex already committed code — ralph commits orchestration state only.
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Finalize Task in prd.json
-
-> **BLOCKING:** If prd.tasks has any task with status='pending' that should be 'completed'
-> based on actual code commits, FIX prd.json BEFORE committing.
-
-```javascript
-// PRD PATH RESOLUTION
-const queuePath = '.ralph/modules-queue.json';
-let currentPrdPath = '.ralph/prd.json';
-if (fileExists(queuePath)) {
-  const queue = readJSON(queuePath);
-  currentPrdPath = queue.modules[queue.currentIndex].prdFile;
-}
-
-const prd = readJSON(currentPrdPath);
-const now = new Date().toISOString();
-
-// Apex updates individual task statuses. Ralph updates overall PRD state.
-const allDone = prd.tasks.every(t => t.status === 'completed' || t.status === 'skipped');
-prd.status = allDone ? 'completed' : prd.tasks.some(t => t.status === 'failed' || t.status === 'blocked') ? 'partial' : 'in_progress';
-
-prd.config.current_iteration++;
-prd.updated_at = now;
-
-writeJSON(currentPrdPath, prd);
-```
-
-### 2. Update progress.txt
-
-Append iteration summary (compact):
-```markdown
-## Iteration {iteration} — Delegated to /apex
-Status: {status} | Completed: {completed}/{total}
-Module: {current_module}
-```
-
-### 3. Stage and Commit (PRD state only)
-
-```bash
-git add {currentPrdPath} .ralph/progress.txt
-[ -f .ralph/modules-queue.json ] && git add .ralph/modules-queue.json
-
-git commit -m "$(cat <<'EOF'
-chore(ralph): PRD state — iteration {iteration}, {completed}/{total} tasks
-
-Module: {current_module}
-
-Co-Authored-By: Claude AI <noreply@anthropic.com>
-EOF
-)"
-
-COMMIT_HASH=$(git rev-parse --short HEAD)
-```
-
-### 4. Record Commit in History
-
-```javascript
-prd.history.push({
-  iteration: prd.config.current_iteration - 1,
-  action: 'iteration-completed',
-  timestamp: now,
-  commit_hash: COMMIT_HASH,
-  notes: "Delegated to /apex"
-});
-writeJSON(currentPrdPath, prd);
-```
-
-### 5. Verify
-
-```bash
-git log -2 --oneline
-```
-
----
-
-## ERROR HANDLING:
-
-- **Commit fails (pre-commit hook):** Fix issue, stage, create NEW commit (don't amend)
-- **Task failed in apex:** PRD already reflects failure status — commit as-is
-
----
-
-## NEXT STEP — IMMEDIATE (NO PAUSE)
-
-IMMEDIATELY proceed to `./step-04-check.md`.
-DO NOT pause. DO NOT summarize to the user. DO NOT ask for confirmation.
-The compact loop in step-04 handles ALL remaining work automatically.