@hanzlaa/rcode 3.6.16 → 4.1.0

package/rihal/workflows/correct-course.md

@@ -1,196 +0,0 @@
-# Workflow: rihal-correct-course
-
-<purpose>
-Load original PRD and architecture docs, compare against current codebase implementation. Identify deviations, classify by type (scope drift, wrong architecture, missing acceptance criteria, tech debt), and produce ordered remediation plan with updated story file.
-</purpose>
-
-
-## Step 0 — Usage check
-
-If `$ARGUMENTS` is empty or contains only `--help` or `-h`:
-
-```
-/rihal-correct-course <argument-here>
-```
-
-**Examples:**
-```
-/rihal-correct-course example 1
-/rihal-correct-course example 2
-```
-
-STOP — do not proceed.
-
-<available_agent_types>
-- `rihal-deviation-analyzer` — compares spec to implementation, classifies gaps
-- `rihal-remediation-planner` — creates ordered fix plan
-</available_agent_types>
-
-## Step 0 — Initialize
-
-```bash
-INIT=$(node .rihal/bin/rihal-tools.cjs init correct-course "$ARGUMENTS")
-```
-
-Parse:
-- `flags.prd` — path to original PRD/requirements document
-- `flags.architecture` — path to original architecture document
-- `deviation_report_path` — `.rihal/DEVIATION-REPORT.md`
-- `remediation_plan_path` — `.planning/plans/corrections/SPRINT.md`
-
-## Step 1 — Load Original Spec and Current Implementation
-
-**If `flags.prd` provided:** Read PRD for:
-- Acceptance Criteria (AC)
-- Feature scope (in-scope, out-of-scope)
-- User personas and use cases
-- Non-functional requirements (performance, security, etc.)
-
-**If `flags.architecture` provided:** Read architecture for:
-- Key design decisions
-- Technology choices and rationale
-- Module/service boundaries
-- Data flow and integrations
-
-Scan current codebase for:
-- Implemented features (by file/module)
-- Test coverage for AC
-- Architecture actual state
-- Known TODOs, FIXMEs, tech debt comments
-
-## Step 2 — Spawn Deviation Analyzer
-
-Spawn `rihal-deviation-analyzer` subagent:
-
-```
-Task tool call:
-  subagent_type: "rihal-deviation-analyzer"
-  description: "Analyze deviations from spec"
-  prompt: |
-    Compare original spec to current implementation and classify deviations.
-    
-    **Original PRD:**
-    {prd_contents}
-    
-    **Original Architecture:**
-    {architecture_contents}
-    
-    **Current Implementation:**
-    {codebase_analysis}
-    
-    **For each deviation, classify:**
-    
-    1. SCOPE DRIFT — Feature added that wasn't in original scope
-       - Impact: Increases maintenance, scope creep
-       - Fix: Isolate, evaluate for removal or acceptance
-    
-    2. WRONG ARCHITECTURE — Implementation doesn't match intended design
-       - Impact: Performance, maintainability, scalability issues
-       - Fix: Refactor to match architecture
-    
-    3. MISSING AC — Acceptance criteria not met by implementation
-       - Impact: Feature incomplete, doesn't meet user needs
-       - Fix: Implement missing AC
-    
-    4. TECH DEBT — Known code quality issues, shortcuts taken
-       - Impact: Future maintenance burden
-       - Fix: Schedule refactoring/rewrite
-    
-    Output: DEVIATION-REPORT.md with per-deviation analysis
-```
-
-## Step 3 — Spawn Remediation Planner
-
-Spawn `rihal-remediation-planner` subagent:
-
-```
-Task tool call:
-  subagent_type: "rihal-remediation-planner"
-  description: "Create remediation plan"
-  prompt: |
-    Create an ordered remediation plan based on deviations.
-    
-    **Deviations to fix:**
-    {deviations_from_report}
-    
-    **Ordering rules:**
-    1. MISSING AC — highest priority (blocks acceptance)
-    2. WRONG ARCHITECTURE — high priority (affects stability)
-    3. SCOPE DRIFT — medium priority (re-evaluate)
-    4. TECH DEBT — low priority (schedule in backlog)
-    
-    For each fix:
-    - Specific task (not vague)
-    - Estimated effort
-    - Dependencies on other fixes
-    - Rollback risk
-    - Acceptance criteria for "fixed"
-    
-    Output: SPRINT.md that can be executed with /rihal-execute
-```
-
-## Step 4 — Generate Report and Plan
-
-Write:
-- `.rihal/DEVIATION-REPORT.md` (analysis)
-- `.planning/plans/corrections/SPRINT.md` (execution plan)
-
-Also update `.rihal/story-current.md` if exists:
-
-Add section to story file:
-```markdown
-## Known Deviations
-
-[Extracted from DEVIATION-REPORT.md]
-
-### Scope Drift
-- {list}
-
-### Architecture Gaps
-- {list}
-
-### Missing AC
-- {list}
-
-### Tech Debt
-- {list}
-
-Remediation: See /rihal-correct-course for ordered fix plan
-```
-
-Print:
-```
-🧭 Deviation Analysis Complete
-
-{deviation_count} deviations found:
-  • {missing_ac_count} missing AC (critical)
-  • {architecture_count} architecture gaps (high)
-  • {scope_drift_count} scope drift (medium)
-  • {tech_debt_count} tech debt (low)
-
-Reports:
-  • Deviation analysis: {deviation_report_path}
-  • Remediation plan: {remediation_plan_path}
-
-Run remediation with:
-/rihal-execute {remediation_plan_path}
-```
-
-## Success Criteria
-
-- DEVIATION-REPORT.md created with all deviations classified
-- SPRINT.md created with ordered fix tasks
-- Story file updated with deviation summary
-- Deviations ordered by priority (AC → Architecture → Scope → Debt)
-
-## On Error
-
-- If PRD missing: skip scope/AC analysis, focus on architecture
-- If architecture missing: skip architecture analysis, focus on features
-- If agents fail: provide template deviation/remediation structure
-
-## ▶ Next Up
-
-- /rihal-execute {phase}
-- /rihal-plan {phase}
-- /rihal-progress