its-magic 0.1.2-35 → 0.1.2-36
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.
- package/README.md +14 -0
- package/package.json +1 -1
- package/template/.cursor/commands/auto.md +86 -547
- package/template/.cursor/commands/execute.md +10 -0
- package/template/README.md +14 -0
- package/template/docs/engineering/auto-orchestration-reference.md +646 -0
- package/template/docs/engineering/runbook.md +15 -0
- package/template/docs/engineering/token-cost-parity-manifest.md +16 -0
- package/template/handoffs/token_cost_runs/README.md +26 -0
- package/template/scripts/check_token_cost_parity.py +69 -0
- package/template/scripts/token_cost_compare.py +40 -0
- package/template/scripts/token_cost_lib.py +108 -0
package/README.md
CHANGED
|
@@ -430,6 +430,20 @@ Compaction behavior:
|
|
|
430
430
|
- `ARCH_HOT_MAX_STORY_SECTIONS` (default `120`)
|
|
431
431
|
Triad hot surfaces (`state.md`, `handoffs/po_to_tl.md`,
|
|
432
432
|
`docs/engineering/architecture.md`) must stay within merged scratchpad caps.
|
|
433
|
+
|
|
434
|
+
### Token-cost measurement and low-cache patterns (US-0080 / DEC-0062)
|
|
435
|
+
|
|
436
|
+
- Prefer **fresh subagent/chat boundaries** per `/auto` phase spawn (see `.cursor/commands/auto.md`).
|
|
437
|
+
- Use explicit **`/auto start-from=<phase>`** when resuming so **`resolved_phase_plan`**
|
|
438
|
+
intersection stays deterministic (**`DEC-0052`**).
|
|
439
|
+
- Select **`TOKEN_PROFILE=lean`** when compatible with your work to reduce scratchpad-driven
|
|
440
|
+
breadth; mandatory gates (**`US-0048`**, **`US-0056`**, **`US-0069`**, **`US-0039`**) stay on.
|
|
441
|
+
- **Comparable** cache-read baselines require identical **`run_class_hash`**; otherwise
|
|
442
|
+
**`TOKEN_COST_RUN_CLASS_MISMATCH`** (no cross-plan gaming).
|
|
443
|
+
- Committed metrics: **`handoffs/token_cost_runs/<orchestrator_run_id>.md`**; link from
|
|
444
|
+
**`docs/engineering/state.md`** via **`token_cost_evidence_ref`**.
|
|
445
|
+
- Tooling: **`scripts/token_cost_lib.py`**, **`scripts/token_cost_compare.py`**,
|
|
446
|
+
**`python scripts/check_token_cost_parity.py --repo .`**.
|
|
433
447
|
Use `python scripts/enforce-triad-hot-surface.py --check` before completing a
|
|
434
448
|
phase that mutates them; use `--rollover` to archive oldest material into
|
|
435
449
|
deterministic packs when over cap (DEC-0054).
|