chore add doctrine-check and stream-of-thought skills

doctrine-check audits a design or diff against Heavy Duty doctrine (HD1) and reports a verdict. stream-of-thought captures an improvement idea in ENHANCEMENTS.org under a Dispatch holding section, tracks it through the file-local Org TODO sequence, and refiles it under a subject-specific heading only on completion. It captures and tracks only; it does not implement.

Commit
02ce5e646b5d5dedf4de54170db4eac96bcdb64b
Author
Marius Peter <dev@marius-peter.com>
Author date
Committer
Marius Peter <dev@marius-peter.com>
Committer date
Changed files
.kiro/skills/doctrine-check/SKILL.md
index 00000000..237a8166 000000..100644
@@ -0,0 +1,121 @@
1 Added: ---
2 Added: name: doctrine-check
3 Added: description: Audit a design choice or a code diff against Mike Mentzer's Heavy Duty doctrine. Use before committing a domain decision, or when a change touches training rules (intensity, volume, recovery, progression, substitution).
4 Added: ---
5 Added:
6 Added: # Doctrine check
7 Added:
8 Added: Audit the target against Heavy Duty doctrine and report the verdict.
9 Added:
10 Added: Target (a design proposal, a diff, or both):
11 Added:
12 Added: $ARGUMENTS
13 Added:
14 Added: If the target is empty, audit the entire project, focusing on the core library.
15 Added:
16 Added: ## Source of truth
17 Added:
18 Added: The doctrine lives in two places, in this order of authority:
19 Added:
20 Added: 1. `doc/Mike_Mentzer_Heavy_Duty_I.md` (HD1) — the primary source. It is
21 Added: copyrighted, gitignored, and never committed. Read it to cite exact wording.
22 Added: 2. `.kiro/steering/domain.md` — the distilled, binding principles. Use it when
23 Added: HD1 is not present.
24 Added:
25 Added: Cite HD1 by section name. The sections are:
26 Added:
27 Added: - I. Bodybuilders Are Confused!
28 Added: - II. A Rational Approach
29 Added: - III. The Science of Bodybuilding
30 Added: - The Intensity Factor
31 Added: - The Economics of Growth and Recovery
32 Added: - Conversations with Dorian Yates
33 Added: - IV. The Ideal (or Principled) Routine
34 Added: - Ensuring Optimal Progress
35 Added: - Proper Exercise Performance
36 Added: - Training to Failure
37 Added: - Proper Weight Selection
38 Added: - The Pre-Stretch
39 Added: - Pre-Exhaustion
40 Added: - Negatives
41 Added: - Warming Up
42 Added: - Intensity and Muscular Function
43 Added: - Equipment
44 Added: - Regulating Volume and Frequency
45 Added: - The Routine
46 Added: - Important Points
47 Added: - V. Individual Potential
48 Added: - The Role of Genetics
49 Added: - VI. On Motivation
50 Added: - The Role of Values
51 Added: - Motivational Techniques
52 Added:
53 Added: ## The rule
54 Added:
55 Added: On a conflict between the target and the doctrine, one of two outcomes holds:
56 Added:
57 Added: 1. The doctrine wins — the target must change, or
58 Added: 2. The conflict is raised explicitly.
59 Added:
60 Added: Never let a conflict pass in silence. A silent deviation is the failure this
61 Added: check exists to prevent.
62 Added:
63 Added: ## What to test against
64 Added:
65 Added: Test the target against each binding principle. Report only the principles the
66 Added: target touches; do not pad the report with untouched ones.
67 Added:
68 Added: - **Intensity is categorical, not scalar.** A working set ends at momentary
69 Added: muscular failure; that is its definition (HD1, "The Intensity Factor": 0% at
70 Added: rest, 100% at failure). Effort past failure is qualitative
71 Added: (`Beyond_failure`: forced reps, negatives, rest-pause, static hold). Flag any
72 Added: numeric "intensity score".
73 Added: - **Recovery produces growth; the gym only stimulates it.** Stimulation is
74 Added: immediate; production is not (HD1, "The Economics of Growth and Recovery").
75 Added: Recovery is systemic and time-based; a hard workout gates the next one.
76 Added: - **Volume beyond the minimum is harmful.** One working set per exercise is
77 Added: nominal; three sets per muscle is the ceiling. The net negative of each extra
78 Added: set increases geometrically. Rising volume is a diagnostic warning, never an
79 Added: achievement or a target.
80 Added: - **Progressive overload is the progress signal.** Progress is more reps,
81 Added: weight, or both; one extra rep counts. Reps are an outcome, never a target —
82 Added: a set ends at failure, not a number. The band only calibrates load. Raise the
83 Added: load 10-20% once twelve reps are reached. A 6-10 band is not breached at
84 Added: eleven.
85 Added: - **Brief, infrequent, intense.** Shorter sessions at equal or better overload
86 Added: are favourable (HD1, "Regulating Volume and Frequency").
87 Added: - **Focus over novelty.** Exercises come from a curated catalog. Substitutions
88 Added: follow author-specified whitelists; a routine may only narrow them.
89 Added: - **On a stall, the answer is never more work.** After two weeks of no
90 Added: progress: a week off, then *reduce* volume and frequency — drop sets, add
91 Added: rest days (HD1, "Regulating Volume and Frequency"). No remedy may add volume
92 Added: or frequency.
93 Added:
94 Added: ## Encoding rules (for code targets)
95 Added:
96 Added: - Prefer making an illegal training state unrepresentable over validating it at
97 Added: runtime.
98 Added: - Deviations (training early, extra volume) must be possible but never silent:
99 Added: require an explicit acknowledgement and retain it.
100 Added: - Keep plan and record distinct: prescription/routine vs logged workout;
101 Added: prescription vs progression.
102 Added: - The logbook records; it never interprets. Invariants belong on authored
103 Added: plans, not on observed history. A log that refuses to state what happened is
104 Added: worse than one that records an error.
105 Added:
106 Added: ## Output
107 Added:
108 Added: Report in this shape:
109 Added:
110 Added: 1. **Verdict** — one line: `Consistent`, `Conflict (doctrine wins)`, or
111 Added: `Conflict (raised)`.
112 Added: 2. **Findings** — for each principle the target touches: the principle, whether
113 Added: the target upholds or breaks it, and the HD1 section (or `domain.md`) that
114 Added: settles it.
115 Added: 3. **Required change** — for each `doctrine wins` conflict, the smallest change
116 Added: that restores consistency.
117 Added: 4. **Raised conflicts** — for each conflict the doctrine cannot settle alone,
118 Added: state the tension plainly and ask for a decision. Do not resolve it silently.
119 Added:
120 Added: Keep it terse. Cite the doctrine for every claim. Do not invent doctrine that
121 Added: is not in HD1 or `domain.md`; if the source is silent, say so.
.kiro/skills/stream-of-thought/SKILL.md
index 00000000..9eaebbc9 000000..100644
@@ -0,0 +1,59 @@
1 Added: ---
2 Added: name: stream-of-thought
3 Added: description: Capture an improvement idea in ENHANCEMENTS.org as an Org TODO, file it under the right section, and keep its status current. Captures and tracks only; never implements.
4 Added: ---
5 Added:
6 Added: # Stream of thought
7 Added:
8 Added: Record an improvement idea and track its status. This skill only captures,
9 Added: files, and tracks; it does not build, test, commit, or dispatch an agent.
10 Added:
11 Added: The idea:
12 Added:
13 Added: $ARGUMENTS
14 Added:
15 Added: If the idea is empty, ask for one line describing the enhancement, then stop.
16 Added:
17 Added: ## Step 1 — Capture under Dispatch
18 Added:
19 Added: Add the idea to `ENHANCEMENTS.org` as a level-2 heading under the top-level
20 Added: `* Dispatch` section, the holding area for every new request. Create
21 Added: `* Dispatch` once, at the top of the file, if it does not exist.
22 Added:
23 Added: ```
24 Added: ** TODO <imperative title under 60 chars>
25 Added: [YYYY-MM-DD Day HH:MM]
26 Added: <the full idea text, verbatim>
27 Added: ```
28 Added:
29 Added: The inactive timestamp records when the request was captured. Match the terse,
30 Added: imperative style of the existing entries and keep the file well-formed. Report
31 Added: the outline path of the new heading.
32 Added:
33 Added: ## Step 2 — Refile on completion
34 Added:
35 Added: A request stays under `* Dispatch` while it is open, `BLOCKED`, or `CANCELLED`.
36 Added: Only when it reaches `DONE` (Step 3), move the whole heading out of `* Dispatch`
37 Added: and under the top-level section that fits its subject.
38 Added:
39 Added: Read the existing top-level (`*`) headings and choose the one that best matches
40 Added: the request's nature. Create a new top-level section only when none fits; keep
41 Added: the name short and consistent with the others. Report the new outline path.
42 Added:
43 Added: ## Step 3 — Track the status
44 Added:
45 Added: Cycle the heading's keyword through the sequence defined in the file's `#+TODO:`
46 Added: header as the request progresses. In order:
47 Added:
48 Added: - `TODO` — captured, not started.
49 Added: - `IN-PROGRESS` — work has started.
50 Added: - `TESTING` — tests running, not yet green.
51 Added: - `TESTED` — tests pass, not yet committed.
52 Added: - `DONE` — build clean, tests pass, formatted, committed. Refile it now (Step 2).
53 Added: - `BLOCKED` — stalled and cannot continue.
54 Added: - `CANCELLED` — abandoned on purpose.
55 Added:
56 Added: Set the keyword only from a state you observed; never claim `DONE` without an
57 Added: observed commit and passing tests. Change the keyword in place; add no other
58 Added: field. Log every request, even one that cannot be carried out — a record that
59 Added: refuses to state what was asked is worse than one recording a failure.