chronicle-mcp: Skill for Claude Code

Conduct Reviewing Loop

Run iterative, independent subagent reviews to stress-test plans (pre-implementation) or validate codebase diffs against approved specifications (post-implementation) against explicit user and system criteria.

Dual-Mode Architecture & Workflows

flowchart TD
    Start["Start Review Loop<br/>(Version = 1, PassCount = 0, SP = !SP or 1)"] --> ModeSelect{"Select Review Mode"}
    
    ModeSelect -->|"Mode A (Pre-Implementation)"| ModeA["Mode A: Design & Plan Audit<br/>(Refine unapproved draft plan/spec)"]
    ModeSelect -->|"Mode B (Post-Implementation)"| ModeB["Mode B: Implementation Validation<br/>(Audit code .diff against approved plan)"]

    ModeA --> SynthA["1. Synthesize Criteria & Task Domain Skills"] --> PrepDraftA["2. Identify/Prepare Target Draft"] --> ReadRefA["3. Read MODE-A-DESIGN-AUDIT.md"] --> SavePromptV["4. Save Prompt to scratch/reviewer_prompt_v1.md"]
    
    ModeB --> SynthB["1. Synthesize Coverage Verification Checklist"] --> GenDiff["2. Generate scratch/patch_changes.diff"] --> ReadRefB["3. Read MODE-B-CODE-VALIDATION.md"] --> SavePromptV
    
    SavePromptV --> UserGateV{"5. User Confirms Prompt?<br/>(Keyword: 'Conduct?')"}
    UserGateV -->|"Confirmed ('Conduct?')"| FreezeV["6. Freeze Prompt as Active Prompt"]
    UserGateV -->|"Prompt Feedback / !PU"| RefinePrompt["Refine Prompt"] --> SavePromptV
    
    FreezeV --> BlindSpawn["7. Spawn Independent Reviewer #N (Using Active Frozen Prompt)"]
    BlindSpawn --> CritEval{"8. Critical Evaluation of Feedback (Main Agent)"}
    
    CritEval -->|"Valid Edits Needed"| ResetPass["Reset PassCount = 0"] --> CheckExc{"New User Request / New Spec / !PU?"}
    
    CheckExc -->|"No (Standard Fix)"| ApplyFix["Apply fixes (Mode A: Draft / Mode B: Code)"] --> CheckPA{"!PA Active AND Not Final PASS?"}
    CheckExc -->|"Yes (!PU / Exception)"| IncVer["Version = Version + 1"] --> SavePromptNew["Save scratch/reviewer_prompt_v{Version}.md"] --> UserGateNew{"User Confirms Prompt?<br/>(Keyword: 'Conduct?')"}
    UserGateNew -->|"Confirmed ('Conduct?')"| FreezeNew["Freeze v{Version} as Active Prompt"] --> ApplyFix
    UserGateNew -->|"Keep Previous"| KeepPrev["Keep Previous Active Prompt"] --> ApplyFix

    CheckPA -->|"Yes (!PA Set)"| PauseLoop["PAUSE: Report Edits & Await User Resume"]
    CheckPA -->|"No"| BranchMode{"Mode?"}
    PauseLoop -->|"User Resumes"| BranchMode

    BranchMode -->|"Mode B"| Regendiff["Re-generate .diff"] --> NextIter["Iteration N = N + 1"] --> BlindSpawn
    BranchMode -->|"Mode A"| NextIter

    CritEval -->|"STATUS: PASS"| PassCounter{"PassCount = PassCount + 1<br/>PassCount >= SP?"}
    PassCounter -->|"Yes (Final PASS)"| Present["9. Present Verified Final Output"]
    PassCounter -->|"No (Not Final PASS)"| CheckPA{"!PA Active AND Not Final PASS?"}

    CritEval -->|"All Points Evaluated Invalid"| JustifyUser["Document Exclusions & Report to User"] --> UserGateFinal{"User Approves Rationale?"}
    UserGateFinal -->|"Approved"| Present
    UserGateFinal -->|"User Rejects Rationale"| ResetPass

    UserFPA["User sends !FPA Mid-Loop"] -.->|"Emergency Signal"| KillReviewer["Kill Running Reviewer #N Subagent<br/>& Discard Feedback"] -.-> PauseLoopEmergency["PAUSE: Emergency Stop & Await User Instructions"]