diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md index 7b05d620e..038d9e054 100644 --- a/autoplan/SKILL.md +++ b/autoplan/SKILL.md @@ -383,6 +383,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/canary/SKILL.md b/canary/SKILL.md index 6cf762034..c2f0a0895 100644 --- a/canary/SKILL.md +++ b/canary/SKILL.md @@ -375,6 +375,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/checkpoint/SKILL.md b/checkpoint/SKILL.md index 22b5d3ad7..f0bf78b83 100644 --- a/checkpoint/SKILL.md +++ b/checkpoint/SKILL.md @@ -378,6 +378,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/codex/SKILL.md b/codex/SKILL.md index 9b40b27e5..621c4ead8 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -377,6 +377,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/cso/SKILL.md b/cso/SKILL.md index 89f2b13fb..6556a4b5d 100644 --- a/cso/SKILL.md +++ b/cso/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index f717625a7..ef3f144aa 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/design-html/SKILL.md b/design-html/SKILL.md index 10aaece0b..3e743a405 100644 --- a/design-html/SKILL.md +++ b/design-html/SKILL.md @@ -382,6 +382,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-review/SKILL.md b/design-review/SKILL.md index 9c404a23a..e6ffe9f7c 100644 --- a/design-review/SKILL.md +++ b/design-review/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md index 95d5bab26..0628f8c70 100644 --- a/design-shotgun/SKILL.md +++ b/design-shotgun/SKILL.md @@ -377,6 +377,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/devex-review/SKILL.md b/devex-review/SKILL.md index 96575feab..a59561d9b 100644 --- a/devex-review/SKILL.md +++ b/devex-review/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/document-release/SKILL.md b/document-release/SKILL.md index 90b84d2d2..7f2e4763d 100644 --- a/document-release/SKILL.md +++ b/document-release/SKILL.md @@ -377,6 +377,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/health/SKILL.md b/health/SKILL.md index f8f7b2ae9..843dfb951 100644 --- a/health/SKILL.md +++ b/health/SKILL.md @@ -377,6 +377,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/investigate/SKILL.md b/investigate/SKILL.md index 30feccd0e..4f3a1a883 100644 --- a/investigate/SKILL.md +++ b/investigate/SKILL.md @@ -392,6 +392,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md index 644020097..0fc3a4438 100644 --- a/land-and-deploy/SKILL.md +++ b/land-and-deploy/SKILL.md @@ -374,6 +374,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/learn/SKILL.md b/learn/SKILL.md index 656ae76b2..3c88385e3 100644 --- a/learn/SKILL.md +++ b/learn/SKILL.md @@ -377,6 +377,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md index bcb3557c1..cdb813ae2 100644 --- a/office-hours/SKILL.md +++ b/office-hours/SKILL.md @@ -384,6 +384,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/open-gstack-browser/SKILL.md b/open-gstack-browser/SKILL.md index 126bd5fb7..7933cb489 100644 --- a/open-gstack-browser/SKILL.md +++ b/open-gstack-browser/SKILL.md @@ -374,6 +374,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/pair-agent/SKILL.md b/pair-agent/SKILL.md index 6a7ddbbbf..2983b2dbd 100644 --- a/pair-agent/SKILL.md +++ b/pair-agent/SKILL.md @@ -375,6 +375,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md index 78e87f4da..9d9045c04 100644 --- a/plan-ceo-review/SKILL.md +++ b/plan-ceo-review/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md index 6003e81fe..d199f40e5 100644 --- a/plan-design-review/SKILL.md +++ b/plan-design-review/SKILL.md @@ -378,6 +378,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/plan-devex-review/SKILL.md b/plan-devex-review/SKILL.md index 56a51ba2b..c5537a970 100644 --- a/plan-devex-review/SKILL.md +++ b/plan-devex-review/SKILL.md @@ -382,6 +382,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md index 93f71bd7b..2a04ab1e9 100644 --- a/plan-eng-review/SKILL.md +++ b/plan-eng-review/SKILL.md @@ -380,6 +380,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md index f1eeedff9..0d4be44aa 100644 --- a/qa-only/SKILL.md +++ b/qa-only/SKILL.md @@ -376,6 +376,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/qa/SKILL.md b/qa/SKILL.md index edb475c90..d60c41aa8 100644 --- a/qa/SKILL.md +++ b/qa/SKILL.md @@ -382,6 +382,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/retro/SKILL.md b/retro/SKILL.md index b2f434198..711ae1c06 100644 --- a/retro/SKILL.md +++ b/retro/SKILL.md @@ -375,6 +375,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/review/SKILL.md b/review/SKILL.md index 9e2965db3..141914880 100644 --- a/review/SKILL.md +++ b/review/SKILL.md @@ -378,6 +378,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/scripts/resolvers/preamble.ts b/scripts/resolvers/preamble.ts index bacbc0f00..4a40444b8 100644 --- a/scripts/resolvers/preamble.ts +++ b/scripts/resolvers/preamble.ts @@ -704,6 +704,23 @@ are shown, synthesize a one-paragraph welcome briefing before proceeding: available]. [Health score if available]." Keep it to 2-3 sentences.`; } +function generateContextHealth(): string { + return `## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief \`[PROGRESS]\` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +\`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.\` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing.`; +} + // Preamble Composition (tier → sections) // ───────────────────────────────────────────── // T1: core + upgrade + lake + telemetry + voice(trimmed) + completion @@ -731,7 +748,7 @@ export function generatePreamble(ctx: TemplateContext): string { generateVendoringDeprecation(ctx), generateSpawnedSessionCheck(), generateVoiceDirective(tier), - ...(tier >= 2 ? [generateContextRecovery(ctx), generateAskUserFormat(ctx), generateCompletenessSection()] : []), + ...(tier >= 2 ? [generateContextRecovery(ctx), generateAskUserFormat(ctx), generateCompletenessSection(), generateContextHealth()] : []), ...(tier >= 3 ? [generateRepoModeSection(), generateSearchBeforeBuildingSection(ctx)] : []), generateCompletionStatus(ctx), ]; diff --git a/setup-deploy/SKILL.md b/setup-deploy/SKILL.md index 41ba613ef..517af2467 100644 --- a/setup-deploy/SKILL.md +++ b/setup-deploy/SKILL.md @@ -378,6 +378,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ship/SKILL.md b/ship/SKILL.md index f3bfd6269..8a0053ba7 100644 --- a/ship/SKILL.md +++ b/ship/SKILL.md @@ -379,6 +379,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/test/fixtures/golden/claude-ship-SKILL.md b/test/fixtures/golden/claude-ship-SKILL.md index f3bfd6269..8a0053ba7 100644 --- a/test/fixtures/golden/claude-ship-SKILL.md +++ b/test/fixtures/golden/claude-ship-SKILL.md @@ -379,6 +379,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/test/fixtures/golden/codex-ship-SKILL.md b/test/fixtures/golden/codex-ship-SKILL.md index a08bf4470..e472b39da 100644 --- a/test/fixtures/golden/codex-ship-SKILL.md +++ b/test/fixtures/golden/codex-ship-SKILL.md @@ -373,6 +373,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: diff --git a/test/fixtures/golden/factory-ship-SKILL.md b/test/fixtures/golden/factory-ship-SKILL.md index 2c6f33a8c..d497a8785 100644 --- a/test/fixtures/golden/factory-ship-SKILL.md +++ b/test/fixtures/golden/factory-ship-SKILL.md @@ -375,6 +375,21 @@ AI makes completeness near-free. Always recommend the complete option over short Include `Completeness: X/10` for each option (10=all edge cases, 7=happy path, 3=shortcut). +## Context Health (soft directive) + +During long-running skill sessions, periodically write a brief `[PROGRESS]` summary +(2-3 sentences: what's done, what's next, any surprises). Example: + +`[PROGRESS] Found 3 auth bugs. Fixed 2. Remaining: session expiry race in auth.ts:147. Next: write regression test.` + +If you notice you're going in circles — repeating the same diagnostic, re-reading the +same file, or trying variants of a failed fix — STOP and reassess. Consider escalating +or calling /checkpoint to save progress and start fresh. + +This is a soft nudge, not a measurable feature. No thresholds, no enforcement. The +goal is self-awareness during long sessions. If the session stays short, skip it. +Progress summaries must NEVER mutate git state — they are reporting, not committing. + ## Repo Ownership — See Something, Say Something `REPO_MODE` controls how to handle issues outside your branch: