@tgoodington/intuition 11.0.1 → 11.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,13 +21,13 @@ The discovery brief's North Star is the ultimate test: does the running system d
21
21
  ## CRITICAL RULES
22
22
 
23
23
  1. You MUST read `.project-memory-state.json` and resolve context_path before anything else.
24
- 2. You MUST read `{context_path}/discovery_brief.md`, `{context_path}/outline.json`, `{context_path}/build_output.json`, and `{context_path}/project_map.md`.
24
+ 2. You MUST read `{context_path}/discovery_brief.md`, `{context_path}/tasks.json`, `{context_path}/build_output.json`, and `docs/project_notes/project_map.md`.
25
25
  3. You MUST integrate before testing. Code that isn't wired in can't be meaningfully tested.
26
26
  4. You MUST NOT write unit tests that test implementation internals. Tests exercise the system from the outside — smoke tests and experience-slice tests only.
27
27
  5. You MUST NOT fix failures that violate user decisions from the specs. Escalate immediately.
28
28
  6. You MUST delegate integration tasks and test writing to subagents. Do not write code yourself.
29
29
  7. You MUST verify against the discovery brief after all tests pass — does the system deliver the North Star?
30
- 8. You MUST update `{context_path}/project_map.md` if integration reveals new information.
30
+ 8. You MUST update `docs/project_notes/project_map.md` if integration reveals new information.
31
31
 
32
32
  ## CONTEXT PATH RESOLUTION
33
33
 
@@ -58,14 +58,13 @@ Step 8: Exit
58
58
 
59
59
  Read these files:
60
60
  1. `{context_path}/discovery_brief.md` — North Star, stakeholders, constraints
61
- 2. `{context_path}/outline.json` — experience slices, tasks, acceptance criteria
61
+ 2. `{context_path}/tasks.json` — experience slices, tasks with design enrichment, acceptance criteria
62
62
  3. `{context_path}/build_output.json` — what was built, files created/modified, any deviations
63
- 4. `{context_path}/specs/*.md` — design specs for technical context
64
- 5. `{context_path}/project_map.md` — component landscape, interactions
63
+ 4. `docs/project_notes/project_map.md` — component landscape, interactions
65
64
 
66
65
  From build_output.json, extract: all files created and modified, task statuses, any escalated issues or deviations.
67
66
 
68
- From outline.json, extract: experience slices (these become the basis for experience-slice tests).
67
+ From tasks.json, extract: experience slices (these become the basis for experience-slice tests).
69
68
 
70
69
  ### Gate Check
71
70
 
@@ -162,7 +161,7 @@ These are the highest-value tests in the system. They walk through each stakehol
162
161
 
163
162
  ### Deriving Tests from Experience Slices
164
163
 
165
- Read `outline.json` and extract the experience slices. For each slice that involves code behavior:
164
+ Read `tasks.json` and extract the experience slices. For each slice that involves code behavior:
166
165
 
167
166
  - **What triggers it**: The test setup
168
167
  - **What the stakeholder does**: The test actions
@@ -185,7 +184,7 @@ Test conventions: [from existing tests]
185
184
  ### ES-[N]: [Title]
186
185
  Stakeholder: [who]
187
186
  Journey: [trigger → action → expected outcome]
188
- Acceptance criteria: [from outline.json]
187
+ Acceptance criteria: [from tasks.json]
189
188
 
190
189
  ## Rules
191
190
  - Test the journey from the stakeholder's perspective
@@ -198,8 +197,7 @@ Acceptance criteria: [from outline.json]
198
197
 
199
198
  ## Spec Sources (read these for expected behavior)
200
199
  - Discovery brief: {context_path}/discovery_brief.md
201
- - Outline: {context_path}/outline.json
202
- - Specs: {context_path}/specs/*.md
200
+ - Tasks: {context_path}/tasks.json
203
201
  ```
204
202
 
205
203
  Run the experience slice tests. Classify and fix failures (Step 6).
@@ -237,7 +235,7 @@ After all tests pass, check the running system against the discovery brief:
237
235
 
238
236
  If something drifts, flag it to the user: "Tests pass, but [specific concern about North Star alignment]."
239
237
 
240
- **Update project map** if integration or testing revealed anything new about how components connect.
238
+ **Update `docs/project_notes/project_map.md`** if integration or testing revealed anything new about how components connect.
241
239
 
242
240
  ## STEP 8: EXIT
243
241
 
@@ -275,7 +273,7 @@ If committing: stage files from build output + integration changes + tests, comm
275
273
  When verifying on a branch:
276
274
  - Run the FULL test suite (parent + branch tests) to catch compatibility issues
277
275
  - Integration must be compatible with parent architecture
278
- - Update the branch's project map, not the parent's
276
+ - Update `docs/project_notes/project_map.md`
279
277
 
280
278
  ## RESUME LOGIC
281
279