agents-inc 0.162.0 → 0.164.0

package/dist/components/wizard/step-sources.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   StepSources
-} from "../../chunk-33ZKIYJM.js";
-import "../../chunk-EN5MEPAS.js";
-import "../../chunk-QM3ZNOWJ.js";
+} from "../../chunk-XHPWTL4I.js";
+import "../../chunk-QGUP3QJF.js";
+import "../../chunk-6MV4JOCL.js";
 import "../../chunk-TSIU7DME.js";
 import "../../chunk-J27W6TXS.js";
 import "../../chunk-WTJ3AY33.js";
-import "../../chunk-MI7LKLD7.js";
-import "../../chunk-K26SBQLO.js";
-import "../../chunk-UNASGGW2.js";
-import "../../chunk-3QBOVV6A.js";
-import "../../chunk-IV42Z63R.js";
+import "../../chunk-ABAZMMG4.js";
+import "../../chunk-K5ITEA3I.js";
+import "../../chunk-XPDVAJDH.js";
+import "../../chunk-AVK2HEKB.js";
+import "../../chunk-UITEKY2R.js";
 import "../../chunk-OI2H6M5I.js";
 export {
   StepSources

package/dist/components/wizard/step-stack.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import {
   StepStack
-} from "../../chunk-RMMEYCEA.js";
-import "../../chunk-VEBEGZUV.js";
+} from "../../chunk-URXIQE7I.js";
+import "../../chunk-XATLUKXK.js";
 import "../../chunk-TSIU7DME.js";
 import "../../chunk-XVAQG2CV.js";
-import "../../chunk-FL2CJ5T5.js";
-import "../../chunk-MI7LKLD7.js";
-import "../../chunk-K26SBQLO.js";
-import "../../chunk-UNASGGW2.js";
-import "../../chunk-3QBOVV6A.js";
-import "../../chunk-IV42Z63R.js";
+import "../../chunk-YRS3QZP2.js";
+import "../../chunk-ABAZMMG4.js";
+import "../../chunk-K5ITEA3I.js";
+import "../../chunk-XPDVAJDH.js";
+import "../../chunk-AVK2HEKB.js";
+import "../../chunk-UITEKY2R.js";
 import "../../chunk-OI2H6M5I.js";
 export {
   StepStack

package/dist/components/wizard/summary-panel.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   SummaryPanel
-} from "../../chunk-4KVJJJG2.js";
-import "../../chunk-QM3ZNOWJ.js";
-import "../../chunk-5J6DO4VW.js";
+} from "../../chunk-LT5GXEB2.js";
+import "../../chunk-6MV4JOCL.js";
+import "../../chunk-4VL3CEOS.js";
 import "../../chunk-TSIU7DME.js";
-import "../../chunk-AQSMNUKJ.js";
-import "../../chunk-K26SBQLO.js";
-import "../../chunk-UNASGGW2.js";
-import "../../chunk-3QBOVV6A.js";
-import "../../chunk-IV42Z63R.js";
+import "../../chunk-B3Y3QMWI.js";
+import "../../chunk-K5ITEA3I.js";
+import "../../chunk-XPDVAJDH.js";
+import "../../chunk-AVK2HEKB.js";
+import "../../chunk-UITEKY2R.js";
 import "../../chunk-OI2H6M5I.js";
 export {
   SummaryPanel

package/dist/components/wizard/toast.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   Toast
-} from "../../chunk-MSUTHS2V.js";
-import "../../chunk-IV42Z63R.js";
+} from "../../chunk-QZX7SYKU.js";
+import "../../chunk-UITEKY2R.js";
 export {
   Toast
 };

package/dist/components/wizard/wizard-layout.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   WizardLayout
-} from "../../chunk-L65XGQKR.js";
-import "../../chunk-4KVJJJG2.js";
-import "../../chunk-MSUTHS2V.js";
-import "../../chunk-4NAWM4OQ.js";
-import "../../chunk-QM3ZNOWJ.js";
-import "../../chunk-5J6DO4VW.js";
+} from "../../chunk-ARYNOWKF.js";
+import "../../chunk-LT5GXEB2.js";
+import "../../chunk-QZX7SYKU.js";
+import "../../chunk-S63LXWMC.js";
+import "../../chunk-6MV4JOCL.js";
+import "../../chunk-4VL3CEOS.js";
 import "../../chunk-TSIU7DME.js";
 import "../../chunk-WTJ3AY33.js";
-import "../../chunk-AQSMNUKJ.js";
-import "../../chunk-K26SBQLO.js";
-import "../../chunk-77YZFVQD.js";
-import "../../chunk-UNASGGW2.js";
-import "../../chunk-3QBOVV6A.js";
-import "../../chunk-IV42Z63R.js";
+import "../../chunk-B3Y3QMWI.js";
+import "../../chunk-K5ITEA3I.js";
+import "../../chunk-PHCPUQVR.js";
+import "../../chunk-XPDVAJDH.js";
+import "../../chunk-AVK2HEKB.js";
+import "../../chunk-UITEKY2R.js";
 import "../../chunk-OI2H6M5I.js";
 export {
   WizardLayout

package/dist/components/wizard/wizard-tabs.js

@@ -2,8 +2,8 @@
 import {
   WizardTabs,
   wizardTabsFor
-} from "../../chunk-4NAWM4OQ.js";
-import "../../chunk-IV42Z63R.js";
+} from "../../chunk-S63LXWMC.js";
+import "../../chunk-UITEKY2R.js";
 export {
   WizardTabs,
   wizardTabsFor

package/dist/components/wizard/wizard.js

@@ -2,35 +2,35 @@
 import {
   Wizard,
   resolveSelectedSkillIds
-} from "../../chunk-IMTWWA3N.js";
-import "../../chunk-XSM3IBMG.js";
-import "../../chunk-33ZKIYJM.js";
-import "../../chunk-RMMEYCEA.js";
-import "../../chunk-L65XGQKR.js";
-import "../../chunk-4KVJJJG2.js";
-import "../../chunk-MSUTHS2V.js";
-import "../../chunk-4NAWM4OQ.js";
-import "../../chunk-S6GX7IJ2.js";
-import "../../chunk-EN5MEPAS.js";
-import "../../chunk-QM3ZNOWJ.js";
-import "../../chunk-VEBEGZUV.js";
-import "../../chunk-57YWAMNT.js";
-import "../../chunk-5J6DO4VW.js";
-import "../../chunk-T2RPUNYP.js";
+} from "../../chunk-ECURHW3T.js";
+import "../../chunk-AOTCIUGX.js";
+import "../../chunk-XHPWTL4I.js";
+import "../../chunk-URXIQE7I.js";
+import "../../chunk-ARYNOWKF.js";
+import "../../chunk-LT5GXEB2.js";
+import "../../chunk-QZX7SYKU.js";
+import "../../chunk-S63LXWMC.js";
+import "../../chunk-DSL66I4N.js";
+import "../../chunk-QGUP3QJF.js";
+import "../../chunk-6MV4JOCL.js";
+import "../../chunk-XATLUKXK.js";
+import "../../chunk-V5GLL2JB.js";
+import "../../chunk-4VL3CEOS.js";
+import "../../chunk-Q4IRRVXK.js";
 import "../../chunk-TSIU7DME.js";
 import "../../chunk-XVAQG2CV.js";
-import "../../chunk-X6KXPRKI.js";
+import "../../chunk-NQXO4LR3.js";
 import "../../chunk-J27W6TXS.js";
-import "../../chunk-VFZF7LVY.js";
-import "../../chunk-FL2CJ5T5.js";
+import "../../chunk-3WVH2CTK.js";
+import "../../chunk-YRS3QZP2.js";
 import "../../chunk-WTJ3AY33.js";
-import "../../chunk-MI7LKLD7.js";
-import "../../chunk-AQSMNUKJ.js";
-import "../../chunk-K26SBQLO.js";
-import "../../chunk-77YZFVQD.js";
-import "../../chunk-UNASGGW2.js";
-import "../../chunk-3QBOVV6A.js";
-import "../../chunk-IV42Z63R.js";
+import "../../chunk-ABAZMMG4.js";
+import "../../chunk-B3Y3QMWI.js";
+import "../../chunk-K5ITEA3I.js";
+import "../../chunk-PHCPUQVR.js";
+import "../../chunk-XPDVAJDH.js";
+import "../../chunk-AVK2HEKB.js";
+import "../../chunk-UITEKY2R.js";
 import "../../chunk-OI2H6M5I.js";
 export {
   Wizard,

package/dist/hooks/init.js

@@ -1,51 +1,51 @@
 #!/usr/bin/env node
 import {
   runDashboardFlow
-} from "../chunk-53XPSAJ4.js";
-import "../chunk-3JDVBHWO.js";
-import "../chunk-WIJM6BX6.js";
-import "../chunk-BR3TNSO3.js";
-import "../chunk-IMTWWA3N.js";
-import "../chunk-XSM3IBMG.js";
-import "../chunk-33ZKIYJM.js";
-import "../chunk-RMMEYCEA.js";
-import "../chunk-L65XGQKR.js";
-import "../chunk-4KVJJJG2.js";
-import "../chunk-MSUTHS2V.js";
-import "../chunk-4NAWM4OQ.js";
-import "../chunk-S6GX7IJ2.js";
-import "../chunk-EN5MEPAS.js";
-import "../chunk-QM3ZNOWJ.js";
-import "../chunk-VEBEGZUV.js";
-import "../chunk-57YWAMNT.js";
-import "../chunk-5J6DO4VW.js";
-import "../chunk-T2RPUNYP.js";
+} from "../chunk-G2JJ5BO5.js";
+import "../chunk-7REKOTKG.js";
+import "../chunk-7ANJQLPJ.js";
+import "../chunk-RGYDFBCT.js";
+import "../chunk-ECURHW3T.js";
+import "../chunk-AOTCIUGX.js";
+import "../chunk-XHPWTL4I.js";
+import "../chunk-URXIQE7I.js";
+import "../chunk-ARYNOWKF.js";
+import "../chunk-LT5GXEB2.js";
+import "../chunk-QZX7SYKU.js";
+import "../chunk-S63LXWMC.js";
+import "../chunk-DSL66I4N.js";
+import "../chunk-QGUP3QJF.js";
+import "../chunk-6MV4JOCL.js";
+import "../chunk-XATLUKXK.js";
+import "../chunk-V5GLL2JB.js";
+import "../chunk-4VL3CEOS.js";
+import "../chunk-Q4IRRVXK.js";
 import "../chunk-TSIU7DME.js";
 import "../chunk-XVAQG2CV.js";
 import "../chunk-ZBPEFQ4G.js";
-import "../chunk-X6KXPRKI.js";
+import "../chunk-NQXO4LR3.js";
 import "../chunk-J27W6TXS.js";
-import "../chunk-VFZF7LVY.js";
-import "../chunk-FL2CJ5T5.js";
+import "../chunk-3WVH2CTK.js";
+import "../chunk-YRS3QZP2.js";
 import "../chunk-WTJ3AY33.js";
-import "../chunk-MI7LKLD7.js";
-import "../chunk-J2YG7P7L.js";
+import "../chunk-ABAZMMG4.js";
+import "../chunk-X4SSJZLY.js";
 import "../chunk-JCPANDNR.js";
-import "../chunk-C53RJ7AA.js";
-import "../chunk-HRVPZMKK.js";
-import "../chunk-ES7WGE32.js";
-import "../chunk-GFO55TMY.js";
-import "../chunk-AQSMNUKJ.js";
+import "../chunk-X37UYIE3.js";
+import "../chunk-2CQNPLVF.js";
+import "../chunk-B6FSLXYN.js";
+import "../chunk-JU4ZGJ7A.js";
+import "../chunk-B3Y3QMWI.js";
 import "../chunk-JFLVEFFP.js";
-import "../chunk-K26SBQLO.js";
+import "../chunk-K5ITEA3I.js";
 import {
   EXIT_CODES
-} from "../chunk-H2MDPOLG.js";
-import "../chunk-2IMHZEIK.js";
-import "../chunk-77YZFVQD.js";
-import "../chunk-UNASGGW2.js";
-import "../chunk-3QBOVV6A.js";
-import "../chunk-IV42Z63R.js";
+} from "../chunk-JIERYE6B.js";
+import "../chunk-NKGYKOB7.js";
+import "../chunk-PHCPUQVR.js";
+import "../chunk-XPDVAJDH.js";
+import "../chunk-AVK2HEKB.js";
+import "../chunk-UITEKY2R.js";
 import "../chunk-OI2H6M5I.js";
 
 // src/cli/hooks/init.ts

package/dist/load-agent-defs-7IM3GBEQ.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  loadAgentDefs
+} from "./chunk-B6FSLXYN.js";
+import "./chunk-JU4ZGJ7A.js";
+import "./chunk-XPDVAJDH.js";
+import "./chunk-AVK2HEKB.js";
+import "./chunk-UITEKY2R.js";
+import "./chunk-OI2H6M5I.js";
+export {
+  loadAgentDefs
+};
+//# sourceMappingURL=load-agent-defs-7IM3GBEQ.js.map

package/dist/recompile-project-agents-VR4NLGOU.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  recompilePropagatedProjectAgents,
+  recompileRegisteredProjectAgents
+} from "./chunk-2CQNPLVF.js";
+import "./chunk-B6FSLXYN.js";
+import "./chunk-JU4ZGJ7A.js";
+import "./chunk-NKGYKOB7.js";
+import "./chunk-XPDVAJDH.js";
+import "./chunk-AVK2HEKB.js";
+import "./chunk-UITEKY2R.js";
+import "./chunk-OI2H6M5I.js";
+export {
+  recompilePropagatedProjectAgents,
+  recompileRegisteredProjectAgents
+};
+//# sourceMappingURL=recompile-project-agents-VR4NLGOU.js.map

package/dist/{source-loader-KAWB76OH.js → source-loader-GRBVNRAW.js}

@@ -4,9 +4,9 @@ import {
   loadMarketplaceMatrix,
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
-} from "./chunk-UNASGGW2.js";
-import "./chunk-3QBOVV6A.js";
-import "./chunk-IV42Z63R.js";
+} from "./chunk-XPDVAJDH.js";
+import "./chunk-AVK2HEKB.js";
+import "./chunk-UITEKY2R.js";
 import "./chunk-OI2H6M5I.js";
 export {
   convertStackToResolvedStack,
@@ -14,4 +14,4 @@ export {
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
 };
-//# sourceMappingURL=source-loader-KAWB76OH.js.map
+//# sourceMappingURL=source-loader-GRBVNRAW.js.map

package/dist/src/agents/_templates/agent.liquid

@@ -1,12 +1,15 @@
 ---
 name: {{ agent.name }}
-description: {{ agent.description }}
+description: {{ agent.description | json }}
 tools: {{ agent.tools | join: ", " }}
 {% if agent.disallowedTools.size > 0 %}disallowedTools: {{ agent.disallowedTools | join: ", " }}
 {% endif %}model: {{ agent.model | default: "inherit" }}
 {% if agent.effort %}effort: {{ agent.effort }}
 {% endif %}permissionMode: {{ agent.permissionMode | default: "default" }}
-{% if preloadedSkillIds.size > 0 %}skills:
+{% if agent.isolation %}isolation: {{ agent.isolation }}
+{% endif %}{% if agent.experimental %}experimental: {{ agent.experimental | json }}
+{% endif %}{% if agent.hooks %}hooks: {{ agent.hooks | json }}
+{% endif %}{% if preloadedSkillIds.size > 0 %}skills:
 {% for skillId in preloadedSkillIds %}  - {{ skillId }}
 {% endfor %}{% endif %}---
 
@@ -18,144 +21,49 @@ tools: {{ agent.tools | join: ", " }}
 
 ---
 
-<core_principles>
-**1. Investigation First**
-Never speculate. Read the actual code before making claims. Base all work strictly on what you find in the files.
-
-**2. Follow Existing Patterns**
-Use what's already there. Match the style, structure, and conventions of similar code. Don't introduce new patterns.
-
-**3. Minimal Necessary Changes**
-Make surgical edits. Change only what's required to meet the specification. Leave everything else untouched.
-
-**4. Anti-Over-Engineering**
-Simple solutions. Use existing utilities. Avoid abstractions. If it's not explicitly required, don't add it.
-
-**5. Verify Everything**
-Test your work. Run the tests. Check the success criteria. Provide evidence that requirements are met.
-
-**DISPLAY ALL 5 CORE PRINCIPLES AT THE START OF EVERY RESPONSE TO MAINTAIN INSTRUCTION CONTINUITY.**
-</core_principles>
-
----
-
-<methodologies>
-
-{% render "methodologies/investigation-requirements" %}
-
----
-
-{% render "methodologies/anti-over-engineering" %}
-
----
-
-{% render "methodologies/write-verification" %}
+{% render "methodologies/operating-principles" %}
 
 ---
 
-{% render "methodologies/success-criteria" %}
-
----
-
-{% render "methodologies/context-management" %}
-
-</methodologies>
-
----
-
-{% if criticalRequirementsTop != "" %}
-<critical_requirements>
+{% if criticalRequirementsTop != "" %}<critical_requirements>
 {{ criticalRequirementsTop }}
 </critical_requirements>
 
 ---
 
-{% endif %}
-{% if dynamicSkills.size > 0 %}
-<skill_activation_protocol>
-## Skill Activation Protocol
-
-**BEFORE implementing ANY task, you MUST follow this three-step protocol for dynamic skills.**
-
-### Step 1 - EVALUATE
-
-For EACH skill listed below, you MUST explicitly state in your response:
-
-| Skill | Relevant? | Reason |
-|-------|-----------|--------|
-| [skill-id] | YES / NO | One sentence explaining why |
-
-Do this for EVERY skill. No exceptions. Skipping evaluation = skipping knowledge.
-
-### Step 2 - ACTIVATE
-
-For EVERY skill you marked **YES**, you MUST invoke the Skill tool **IMMEDIATELY**.
-
-```
-skill: "[skill-id]"
-```
-
-**Do NOT proceed to implementation until ALL relevant skills are loaded into your context.**
-
-### Step 3 - IMPLEMENT
-
-**ONLY after** Step 1 (evaluation) and Step 2 (activation) are complete, begin your implementation.
+{% endif %}{{ playbook }}
 
 ---
 
-**CRITICAL WARNING:**
-
-Your evaluation in Step 1 is **COMPLETELY WORTHLESS** unless you actually **ACTIVATE** the skills in Step 2.
+{% if criticalReminders != "" %}<critical_reminders>
+{{ criticalReminders }}
+</critical_reminders>
 
-- Saying "YES, this skill is relevant" without invoking `skill: "[skill-id]"` means that knowledge is **NOT AVAILABLE TO YOU**
-- The skill content **DOES NOT EXIST** in your context until you explicitly load it
-- You are **LYING TO YOURSELF** if you claim a skill is relevant but don't load it
-- Proceeding to implementation without loading relevant skills means you will **MISS PATTERNS, VIOLATE CONVENTIONS, AND PRODUCE INFERIOR CODE**
+---
 
-**The Skill tool exists for a reason. USE IT.**
+{% endif %}{% if output != "" %}{{ output }}
 
 ---
 
-## Available Skills (Require Loading)
+{% endif %}<system-reminder>
+Compiled by {{ generatorVersion }}.
 
-{% for skill in dynamicSkills %}
-### {{ skill.id }}
+{% if dynamicSkills.size > 0 %}<skill_activation_protocol>
+The skills below are available through the Skill tool. Open a task by naming which of them it
+touches and loading those first — a skill carries the conventions this project expects for its
+area, and its content reaches you only once you invoke it.
+
+{% for skill in dynamicSkills %}### {{ skill.id }}
 - Description: {{ skill.description }}
 - Invoke: `skill: "{{ skill.pluginRef | default: skill.id }}"`
-- Use when: {{ skill.usage }}
+- {{ skill.usage }}
 
-{% endfor %}
-</skill_activation_protocol>
-{% else %}
-<skills_note>
-All skills for this agent are preloaded via frontmatter. No additional skill activation required.
+{% endfor %}</skill_activation_protocol>
+{% elsif preloadedSkillIds.size > 0 %}<skills_note>
+This agent's skills are preloaded through its frontmatter, so their content is already in context.
 </skills_note>
-{% endif %}
-
----
-
-{{ playbook }}
-
----
-
-## Standards and Conventions
-
-All code must follow established patterns and conventions:
-
----
-
-{{ output }}
-
----
-
-{% if criticalReminders != "" %}
-<critical_reminders>
-{{ criticalReminders }}
-</critical_reminders>
-
----
-
-{% endif %}
-**DISPLAY ALL 5 CORE PRINCIPLES AT THE START OF EVERY RESPONSE TO MAINTAIN INSTRUCTION CONTINUITY.**
-
-**ALWAYS RE-READ FILES AFTER EDITING TO VERIFY CHANGES WERE WRITTEN. NEVER REPORT SUCCESS WITHOUT VERIFICATION.**
+{% else %}<skills_note>
+No skills are configured for this agent. The Skill tool is available, so a skill this project adds
+later can be loaded by name.
+</skills_note>
+{% endif %}</system-reminder>

package/dist/src/agents/_templates/methodologies/operating-principles.liquid

@@ -0,0 +1,27 @@
+<operating_principles>
+
+**Work from what you have read.** Open the files a task names before making a claim about them.
+Where you need a file you have not got, say which one and why.
+
+**Treat a specification as a claim.** Every path, symbol, signature and count in it was measured
+against a tree that has since moved. Re-derive each one. Where an instruction does not describe what
+you find, stop on that item, report it with the command you ran and what it returned, and continue
+with the rest — never inventing work to make the instruction true, and never quietly widening it
+into something that is. **Corrections are a required field of your report** — list what proved
+false, and write "Corrections: nothing" when nothing did.
+
+**Match what is already there.** Reach for the existing utility, pattern or shape. New abstractions
+earn their place by being asked for.
+
+**Change what the task names.** Where a defect turns out to be one instance of a class, run the
+search that finds its siblings and list them with their locations, repairing them where repair is
+the task — stating the search you ran and what it returned, including when it returned nothing.
+Where your work lands a rule or an invariant, name the specific thing that would catch a violation
+of it — the test that fails, the type that stops compiling, the check that reports — or say plainly
+that nothing would.
+
+**Carry three things out of every task, in your report:** the decisions you made and why, the
+gotchas you hit, and the work you deliberately left with what stopped you — a project gets the files
+it asked for and no others.
+
+</operating_principles>

package/dist/src/agents/developer/ai-developer/critical-reminders.md

@@ -1,54 +1,15 @@
-## ⚠️ CRITICAL REMINDERS
-
-**CRITICAL: Make minimal and necessary changes ONLY. Do not modify anything not explicitly mentioned in the specification. Use existing utilities instead of creating new abstractions. Follow existing patterns exactly -- no invention.**
-
-This is the most important rule. Most quality issues stem from violating it.
-
-**(You MUST read the COMPLETE spec before writing any code - partial understanding causes spec violations)**
-
-**(You MUST find and examine at least 2 similar existing AI modules before implementing - follow existing patterns exactly)**
-
-**(You MUST validate ALL LLM responses with schemas - non-deterministic output breaks silently without validation)**
-
-**(You MUST include retry logic with exponential backoff for all LLM API calls - transient failures are normal, not exceptional)**
-
-**(You MUST check token counts before sending prompts - exceeding context windows causes silent truncation or hard errors)**
-
-**(You MUST re-read files after editing to verify changes were written - never report success without verification)**
-
-**(You MUST run tests and verify they pass - never claim success without test verification)**
-
-**(You MUST record a finding the way this project's conventions direct when you fix an anti-pattern, discover a missing standard, or notice convention drift)**
-
-**AI-Specific Reminders:**
-
-- Use config/environment variables for model names -- never hardcode
-- Use parameterized templates for prompt construction -- never string concatenation
-- Set explicit termination conditions on agent loops (max iterations + success criteria)
-- Handle streaming connection drops and partial chunks
-- Cache embeddings to avoid redundant computation
-
-**Failure to follow these rules will produce brittle, expensive, and unpredictable AI code.**
-
 <post_action_reflection>
-**After Completing Each Major Step (Investigation, Implementation, Testing):**
-
-Pause and evaluate:
 
-1. **Did this achieve the intended goal?**
-   - If investigating: Do I understand the patterns completely?
-   - If implementing: Does the code match the established patterns?
-   - If testing: Do tests cover all requirements, including non-deterministic output?
+**After each major step — investigation, implementation, testing — take stock:**
 
-2. **What did I learn that affects my approach?**
-   - Did I discover utilities I should use?
-   - Did I find patterns different from my assumptions?
-   - Should I adjust my implementation plan?
+1. Did the step do what it was for? Investigation means you can name the patterns; implementation
+   means the code matches them; testing means the tests cover the requirements, including what the
+   pipeline does when the model's output is not what it expected.
+2. What did you learn that changes the approach — a utility you should be using, a pattern that
+   differs from what you assumed, a plan worth adjusting?
+3. What is still missing — a file you have not read, an edge case you have not considered, or
+   something in the specification that is still unclear?
 
-3. **What gaps remain?**
-   - Do I need to read additional files?
-   - Are there edge cases I haven't considered?
-   - Is anything unclear in the specification?
+Settle the answers before you start the next step, and carry them into your report.
 
-**Only proceed to the next step when confident in your current understanding.**
 </post_action_reflection>