Cline rules

1# Cline Recursive Chain-of-Thought System (CRCT) - Cleanup/Consolidation Plugin (Worker Focus)
2 
3This Plugin provides procedures for a Worker instance within the Cleanup/Consolidation
4phase. A Worker is invoked by a Dispatcher (`cleanup_consolidation_dispatcher_plugin.md`)
5to process ONE batch of ≤10 files (or one single-shot consolidation job) as a standalone,
6self-contained assignment.
7 
8## Core Concept (Worker Perspective)
9 
10- You are a Worker instance. Your sole focus is the assigned batch/job.
11- You manually verify outcomes — a "Completed" marker is never trusted without examining
12  the actual artifact (code or documentation).
13- You record findings in your Worker Output file and append consolidated knowledge to
14  `consolidation_notes.md`.
15- CRITICAL: You DO NOT archive or delete anything, DO NOT modify
16  `.clinerules/default-rules.md`, DO NOT edit shared trackers (`project_roadmap.md`,
17  checklists, `progress.md`) — you REPORT required corrections to the Dispatcher instead,
18  and you NEVER interact with the user.
19 
20> **IMPORTANT**
21> - If you have already read a file and have not edited it since, DO NOT read it again.
22> - Do not use tool XML tags in general responses.
23> - Process every file in the batch; partial batch coverage is a failure.
24 
25## Entering (Worker Role)
26 
27Triggered by a Dispatcher message. Proceed directly to Section I.
28 
29## I. Worker Task Execution
30 
31### Guiding Principles
321. **Batch Atomicity.** Every file in the assigned list is fully processed before completion.
332. **Manual Verification Is Non-Negotiable.** For execution tasks, examine the target
34   artifact (read the actual code/doc). For strategy tasks, confirm the planned output
35   exists and is complete.
363. **Unverified ⇒ Status Invalidated.** If a task marked "Completed" fails verification,
37   update the task file itself to "Status: Incomplete — Outcome Not Verified" (you own
38   in-batch files), and LIST the shared documents requiring correction in your Worker
39   Output file for the Dispatcher.
404. **Extract Everything Lasting.** Design decisions, architecture changes, gotchas, and
41   learnings are appended to `consolidation_notes.md` tagged with the Batch ID and source file.
42 
43### Step W.1: Initialize
441. Parse Dispatcher message: Batch ID, category/type, file list, pointers
45   (`consolidation_notes.md` path, prior-area results for Types B/F).
462. Create `Worker_Output_Cleanup_[BatchID]_[Timestamp].md` in `cline_docs/dispatch_logs/`.
473. State: "Worker initialized. Batch `[ID]`, Type `[X]`, `[N]` files."
48 
49### Step W.2: Execute by Sub-Task Type
50 
51**Type A — Task Instruction Batch Verification** (per file):
521. `read_file` the task file.
532. Verify outcome manually:
54   - Execution tasks: examine the target artifact (`read_file` the code/doc, or
55     `list_files` for existence). Consult `changelog.md` entries if helpful.
56   - Strategy tasks: confirm the planned output (document, analysis, requirements) exists
57     and meets the task's objectives.
583. If NOT verified: update the task file status to invalidate "Completed"; record the
59   discrepancy; list referencing shared documents for Dispatcher correction. The file is
60   NOT eligible for archival — note this explicitly.
614. Extract consolidatable information (decisions, learnings, gotchas) regardless of
62   verification status; append to `consolidation_notes.md`
63   (e.g., "Batch A1, task_xyz.md: Learned that algorithm X is suboptimal for large datasets").
64 
65**Type B — Implementation Plan Batch Review** (per file):
661. `read_file` the plan.
672. Cross-reference its child tasks against Area 1 verification results (via
68   `consolidation_notes.md` / Worker Output pointers supplied by Dispatcher).
693. Update the plan file to reflect true child-task completion status (in-batch edit).
704. Extract strategic information not yet in higher-tier HDTA; append to `consolidation_notes.md`.
71 
72**Type C — Strategic Tracker Batch Review** (per file group):
731. If multiple versions of one tracker exist in the batch: read all; identify newest;
74   consolidate incomplete/pending items and still-relevant completed context from older
75   versions into the newest (in-batch edits). Mark older versions as consolidated and
76   archival-eligible in your output.
772. Update the active version's items against verified task statuses (reported corrections
78   for shared docs go to the Dispatcher; in-batch tracker files you may edit).
793. Extract insights; append to `consolidation_notes.md`.
80 
81**Type D — Changelog Reorganization** (single job):
821. `read_file` the full `changelog.md`.
832. Parse entries (Date, Summary, Description, Impact, Files Modified).
843. Determine primary component per entry from file paths (module, documentation category,
85   CRCT System, Cross-Cutting, General).
864. Group by component; sort entries newest-first within each group.
875. Reconstruct the full file: `# Changelog`, component headings, preserved entry structure,
88   `---` separators. Overwrite with `write_to_file` (justified: complete restructure).
89 
90**Type E — Learning Journal Refinement** (single job):
911. Read `[LEARNING_JOURNAL]` from `default-rules.md` (READ ONLY — do not write
92   `default-rules.md` yourself).
932. Produce in your Worker Output file the refined journal: combined duplicates, removed
94   granular/transient entries, clarified wording, plus NEW entries sourced from
95   `consolidation_notes.md`.
963. The Dispatcher applies the refined journal to `default-rules.md`.
97 
98**Type F — HDTA Document Update** (per assigned document):
991. `read_file` the target document (`system_manifest.md`, `*_module.md`, or
100   `implementation_plan_*.md`) and the referenced `consolidation_notes.md` sections.
1012. Integrate the consolidated knowledge logically; state reasoning per update with source
102   references.
1033. Save with `write_to_file`/`apply_diff`. Report completion in your Worker Output file.
104 
105### Step W.3: Final Worker MUP & Completion Signal
1061. Verify all in-batch edits saved; all notes appended to `consolidation_notes.md`.
1072. Finalize Worker Output file: per-file verdicts (verified / unverified / consolidated),
108   shared-document correction list, archival-eligibility notes, status "[x] Completed".
1093. Use `<attempt_completion>`.
110 
111CRITICAL FOR WORKER: No `default-rules.md` changes. No archiving/deleting. No
112`ask_followup_question`. Shared-document corrections are reported, not applied.
113 
114## II. Quick Reference (Worker Focus)
115 
116**Workflow:** W.1 Initialize (parse batch, create Output file) → W.2 Execute type
117(A: verify+extract tasks / B: review plans / C: consolidate trackers / D: changelog reorg /
118E: journal refinement / F: HDTA update) → W.3 Finalize + `<attempt_completion>`.
119 
120**Key Outputs:** Worker Output file, appended `consolidation_notes.md`, in-batch file
121status updates, reported corrections for Dispatcher-owned documents.
122 
123## III. Flowchart (Worker Focus)
124 
125```mermaid
126graph TD
127    subgraph Worker Instance
128        CW_Start(Dispatcher Message) --> CW_Init[W.1: Parse batch, create Output file];
129        CW_Init --> CW_Exec[W.2: Process every file per Type A-F];
130        CW_Exec --> CW_Verify{All files covered?};
131        CW_Verify -- No --> CW_Exec;
132        CW_Verify -- Yes --> CW_Notes[Append consolidation_notes.md];
133        CW_Notes --> CW_End[W.3: Finalize Output, <attempt_completion>];
134    end
135```
136