Skip to content

Commit fdd7bc0

Browse files
blafourcadeclaude
andauthored
docs(aidd-context): refresh plugin README for the reworked skills (#285)
The onboard, learn, and project-memory rows and the Onboarding section still described the old behavior (state matrix, five-option menu, capture into rules). Align them with the reworked skills (plain-language guide, scored routing, capability-based memory) and regenerate the catalog. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent da350b4 commit fdd7bc0

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

plugins/aidd-context/README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,27 +8,27 @@ Knowledge production plugin for the AI-Driven Development framework.
88
99
First time? Install with `/plugin install aidd-context@aidd-framework`, then run `aidd-context:00-onboard`.
1010

11-
Covers project bootstrap, project initialisation, generation of Claude Code context artifacts (skills, agents, rules, commands, hooks), Mermaid diagrams, learning, discovery, and a state-aware onboarding loop.
11+
Covers project bootstrap, the project memory bank, generation of context artifacts (skills, agents, rules, commands, hooks), Mermaid diagrams, learning, discovery, recipes, and a plain-language onboarding guide.
1212

1313
## Skills
1414

1515
| Bracket ID | Skill | Description |
1616
| ---------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
17-
| [1.0] | [onboard](skills/00-onboard/README.md) | Detect the project's aidd-context state and guide the user to ONE next aidd-context action through a state -> recommend -> execute loop. |
17+
| [1.0] | [onboard](skills/00-onboard/README.md) | Guide the user through the AIDD flow on the current project, in plain language, and suggest the next logical step, adapted to the installed plugins. |
1818
| [1.1] | [bootstrap](skills/01-bootstrap/README.md) | Imagine and validate the technical architecture of a new SaaS through interactive Q&A, candidate-stack comparison, multi-agent audit, and an INSTALL.md output. |
19-
| [1.2] | [project-memory](skills/02-project-memory/README.md) | Initialize the project memory bank (rule directories are created lazily by `03-context-generate`). |
20-
| [1.3] | [context-generate](skills/03-context-generate/README.md) | Generate Claude Code context artifacts - router-based skills, agents, rules, slash commands, hooks, plugin scaffolds, and plugin marketplaces. |
19+
| [1.2] | [project-memory](skills/02-project-memory/README.md) | Initialize or refresh the project memory bank from a capability-based model, and carry the memory block into the AI context files. |
20+
| [1.3] | [context-generate](skills/03-context-generate/README.md) | Generate context artifacts: router-based skills, agents, rules, slash commands, hooks, plugin scaffolds, and plugin marketplaces. |
2121
| [1.4] | [mermaid](skills/09-mermaid/README.md) | Generate high-quality Mermaid diagrams from markdown content using a structured plan-validate workflow. |
22-
| [1.5] | [learn](skills/10-learn/README.md) | Capture and store learnings from recently implemented features into memory bank, decisions, or coding rules. |
22+
| [1.5] | [learn](skills/10-learn/README.md) | Capture durable learnings from the conversation or git history, score each, and route the worthwhile ones to memory, a decision record, a rule, or a new skill. |
2323
| [1.6] | [discovery](skills/11-discovery/README.md) | Help users discover installed skills and find the right one for their use case. |
2424
| [1.7] | [cook](skills/12-cook/README.md) | Maintain the project's `recipes/` how-to sheets: list every recipe, or create and update one from the canonical recipe template. |
2525

2626
## Onboarding
2727

28-
New to aidd-context, or unsure what to run next? Invoke `aidd-context:00-onboard`. The skill:
28+
New to AIDD, or unsure what to run next? Invoke `aidd-context:00-onboard`. The skill:
2929

30-
1. Probes the filesystem (no questions) to snapshot what already exists - `aidd_docs/`, memory bank, rules skeleton, the `<aidd_project_memory>` block in your AI context file.
31-
2. Picks ONE next aidd-context skill from the state matrix and presents a 5-option numbered menu (run / explain / handoff / swap / stop).
32-
3. Loops back to detection after each execution so the recommendation always reflects current state.
30+
1. Reads the project silently: the memory bank, the code and stack, any spec or plan, and which AIDD plugins are installed.
31+
2. Explains in plain language where the project sits in the AIDD flow and suggests the next logical step, resolved to a skill that is actually installed, then offers a short numbered menu.
32+
3. Loops back to reading the project after each step so the guidance always reflects the current state.
3333

34-
The onboard skill is scoped to aidd-context only. Cross-plugin global walkthroughs live elsewhere in the framework.
34+
Onboard adapts to whatever plugins are installed: it suggests by function and discovers the skills that fill each step, so a skill added later shows up on its own.

0 commit comments

Comments
 (0)