From 9c54b8fe9553227b6b275269bdbac449d9006a51 Mon Sep 17 00:00:00 2001 From: Baptiste LAFOURCADE Date: Fri, 10 Jul 2026 13:14:20 +0200 Subject: [PATCH 1/2] fix(aidd-context): the state block carries the tech stack The foundations step count says "1 of 2" on an existing repo and "1 of 3" on a greenfield one, but the state block listed only AI tools, plugins and memory. The stack was a foundation the reader could not see, so the count had to be justified by a sentence the model was free to drop -- and did. Give the stack its own row. The count now reads off the block: a green stack means it does not count. Co-Authored-By: Claude Opus 4.8 --- plugins/aidd-context/CATALOG.md | 2 +- .../aidd-context/skills/00-onboard/actions/03-present.md | 1 + plugins/aidd-context/skills/00-onboard/assets/report.md | 7 ++++--- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/plugins/aidd-context/CATALOG.md b/plugins/aidd-context/CATALOG.md index 07249a81..1783a184 100644 --- a/plugins/aidd-context/CATALOG.md +++ b/plugins/aidd-context/CATALOG.md @@ -1,6 +1,6 @@ # aidd-context catalog -Auto-generated framework content: agents, commands, rules, skills, and templates. +Auto-generated index of skills, agents, references and assets shipped by the `aidd-context` plugin. > This file is automatically updated by the `scripts/summarize-markdown.js` script. diff --git a/plugins/aidd-context/skills/00-onboard/actions/03-present.md b/plugins/aidd-context/skills/00-onboard/actions/03-present.md index 8372be56..e70a9934 100644 --- a/plugins/aidd-context/skills/00-onboard/actions/03-present.md +++ b/plugins/aidd-context/skills/00-onboard/actions/03-present.md @@ -16,6 +16,7 @@ The rendered screen, and the user's reply. - Framing line on the first report of the session only. - Exactly one action block per screen, carrying its key once. - The idle menu is a next-action block. Slot 1 is the action line, slots 2 to 4 join the options line. Never a list. + - The state block carries every foundation, so the foundations step count reads off it. - Glyphs: ✅ met · ⚠️ present, not wired · ❌ missing. - A used tool that lacks the block is `⚠️`, never `❌`. Only a missing required foundation takes `❌`. - Every `⚠️` shows its cause and a keyed fix. diff --git a/plugins/aidd-context/skills/00-onboard/assets/report.md b/plugins/aidd-context/skills/00-onboard/assets/report.md index 811a6751..da670529 100644 --- a/plugins/aidd-context/skills/00-onboard/assets/report.md +++ b/plugins/aidd-context/skills/00-onboard/assets/report.md @@ -8,9 +8,10 @@ 👋 Your AIDD setup: - AI tools - Plugins ✅ - Memory + AI tools + Plugins ✅ + Tech stack <✅ established | ❌ not chosen yet> + Memory From 366b7d3ff5a0860e09b008e1d579b2756d2b96d3 Mon Sep 17 00:00:00 2001 From: Baptiste LAFOURCADE Date: Fri, 10 Jul 2026 13:23:46 +0200 Subject: [PATCH 2/2] fix(aidd-context): onboard keys never collide with host shortcuts `?` opens the help prompt in Claude Code, so the detail key could never be pressed. `<` was a punctuation key for the same reason of habit, not need. Details moves to `[d]`, back to `[b]`, and a render rule reserves keys to letters and digits so the next key cannot repeat the mistake. Co-Authored-By: Claude Opus 4.8 --- plugins/aidd-context/skills/00-onboard/actions/03-present.md | 3 ++- plugins/aidd-context/skills/00-onboard/actions/04-run.md | 2 +- plugins/aidd-context/skills/00-onboard/assets/report.md | 4 ++-- .../aidd-context/skills/00-onboard/references/run/replies.md | 4 ++-- 4 files changed, 7 insertions(+), 6 deletions(-) diff --git a/plugins/aidd-context/skills/00-onboard/actions/03-present.md b/plugins/aidd-context/skills/00-onboard/actions/03-present.md index e70a9934..5c60a777 100644 --- a/plugins/aidd-context/skills/00-onboard/actions/03-present.md +++ b/plugins/aidd-context/skills/00-onboard/actions/03-present.md @@ -22,7 +22,8 @@ The rendered screen, and the user's reply. - Every `⚠️` shows its cause and a keyed fix. - Short lines. - The options line is the last line. Print nothing after it, no detail block, no state snapshot, no hint about what comes next. - - Command ids, tier clauses, and lookahead only under `[?]`. + - Command ids, tier clauses, and lookahead only under `[d]`. + - Keys are letters or digits. Never `?`, `!`, `/`, `@`, `#`: the host takes those. 2. **Inject.** - Entry screen takes `@../assets/banner.txt`. - Flow or walk screen loads `@../references/flow.md`. diff --git a/plugins/aidd-context/skills/00-onboard/actions/04-run.md b/plugins/aidd-context/skills/00-onboard/actions/04-run.md index 1bb70b26..2791d965 100644 --- a/plugins/aidd-context/skills/00-onboard/actions/04-run.md +++ b/plugins/aidd-context/skills/00-onboard/actions/04-run.md @@ -29,5 +29,5 @@ The reply carried out. - `OK` runs AUTO unattended and pauses at each GUIDED. - A MANUAL step is shown, never run. - A gap invokes nothing. -- `?`/`back` re-render with no re-scan. +- `d`/`back` re-render with no re-scan. - A GUIDED handoff emits the return line. diff --git a/plugins/aidd-context/skills/00-onboard/assets/report.md b/plugins/aidd-context/skills/00-onboard/assets/report.md index da670529..e100e2b7 100644 --- a/plugins/aidd-context/skills/00-onboard/assets/report.md +++ b/plugins/aidd-context/skills/00-onboard/assets/report.md @@ -56,11 +56,11 @@ Foundations — step of ``` -## [?] detail +## [d] detail ```txt Details — 1. () - explain · explain project · recap · stop · back [<] + explain · explain project · recap · stop · back [b] ``` diff --git a/plugins/aidd-context/skills/00-onboard/references/run/replies.md b/plugins/aidd-context/skills/00-onboard/references/run/replies.md index a7776ec2..9108bf7c 100644 --- a/plugins/aidd-context/skills/00-onboard/references/run/replies.md +++ b/plugins/aidd-context/skills/00-onboard/references/run/replies.md @@ -4,8 +4,8 @@ | ------------- | --------------------------------------------------------------------------------- | | a number `[n]`| run that step, or open an idle-menu umbrella | | `OK` | walk the pending steps (ranks 1-3) in order, never the idle menu | -| `?` | expand the full detail (command ids, tier clauses, per-check reasons), read-only | -| `back` / `<` | re-render the prior screen, read-only, no re-scan | +| `d` / `details` | expand the full detail (command ids, tier clauses, per-check reasons), read-only | +| `b` / `back` | re-render the prior screen, read-only, no re-scan | | `recap` | summarize this session's conversation, read-only, only when a prior conversation exists | | `explain ` | describe a step in two or three plain lines, read-only | | `explain project` | summarize the project from its memory bank, read-only, only when memory is filled |