From bb475ec0a2967139c67c97281913466bf6ca6b0d Mon Sep 17 00:00:00 2001 From: Baptiste LAFOURCADE <119650761+blafourcade@users.noreply.github.com> Date: Mon, 6 Jul 2026 07:14:02 +0200 Subject: [PATCH 1/8] ci(framework): stop release-please re-tagging aidd-ui (#394) Remove the aidd-ui package from release-please-config.json. Its release-as: 0.1.0-alpha.0 pin forced the same version on every run, so any change touching aidd-ui made release-please retry the existing aidd-ui-v0.1.0-alpha.0 tag and fail (Validation Failed: already_exists). Dropping it from the config freezes aidd-ui at its current alpha while it is still a scaffold; re-add it with proper prerelease handling when it is ready to version. Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt Co-authored-by: Claude Opus 4.8 --- release-please-config.json | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/release-please-config.json b/release-please-config.json index 1d887fb4..256c699f 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -82,17 +82,6 @@ "jsonpath": "$.version" } ] - }, - "plugins/aidd-ui": { - "package-name": "aidd-ui", - "release-as": "0.1.0-alpha.0", - "extra-files": [ - { - "type": "json", - "path": ".claude-plugin/plugin.json", - "jsonpath": "$.version" - } - ] } } } From 7e54ef9c1627399f89c22a092cc6dcbb2df35ce3 Mon Sep 17 00:00:00 2001 From: Baptiste LAFOURCADE <119650761+blafourcade@users.noreply.github.com> Date: Mon, 6 Jul 2026 07:21:58 +0200 Subject: [PATCH 2/8] ci(framework): drop the aidd-ui release-as pin, keep it consistent (#395) Restore the aidd-ui package block in release-please-config.json so it matches the other seven plugins (package-name + extra-files), but without the release-as: 0.1.0-alpha.0 pin. The pin forced the same version every run, retrying the existing aidd-ui-v0.1.0-alpha.0 tag and failing (already_exists). Supersedes the block removal in #394: aidd-ui stays release-managed like its siblings; the next change bumps it to a fresh version instead of colliding. Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt Co-authored-by: Claude Opus 4.8 --- release-please-config.json | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/release-please-config.json b/release-please-config.json index 256c699f..85d6d3ac 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -82,6 +82,16 @@ "jsonpath": "$.version" } ] + }, + "plugins/aidd-ui": { + "package-name": "aidd-ui", + "extra-files": [ + { + "type": "json", + "path": ".claude-plugin/plugin.json", + "jsonpath": "$.version" + } + ] } } } From e36035ef23b8f20060d4ed4d4938c38d7a0f16fb Mon Sep 17 00:00:00 2001 From: Baptiste LAFOURCADE <119650761+blafourcade@users.noreply.github.com> Date: Tue, 7 Jul 2026 06:06:06 +0200 Subject: [PATCH 3/8] refactor: remove per-skill README.md mirrors (#302) (#396) * refactor: remove per-skill README.md mirrors, retarget to SKILL.md Delete the 39 per-skill README.md files that mirrored their SKILL.md, merge the genuinely-unique content from the 7 outlier READMEs into SKILL.md (memory-bank-optional note, install prerequisite, experimental status), retarget plugin-level README skill tables and CREATE_PLUGIN.md to SKILL.md, and regenerate every plugin CATALOG.md. Phase 1 of aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme. Co-Authored-By: Claude Opus 4.8 * chore: mark phase 2 done for remove-per-skill-readme plan All verify-and-guard gates pass: check-markdown-links.js exits 0, zero plugins/*/skills/*/README.md remain, every affected skill dir still has SKILL.md, both asset READMEs and all plugin-level/framework READMEs are intact, sync-readme-counts.mjs --check exits 0, no CATALOG lists a per-skill README row, and 04-skill-generate scaffolds no per-skill README. Co-Authored-By: Claude Opus 4.8 * chore: mark remove-per-skill-readme plan implemented Both phases done and validation green (check-markdown-links.js and sync-readme-counts.mjs --check both exit 0). Co-Authored-By: Claude Opus 4.8 * chore: mark remove-per-skill-readme plan reviewed --------- Co-authored-by: Claude Opus 4.8 --- .../phase-1.md | 84 +++++++++++++++++++ .../phase-2.md | 47 +++++++++++ .../plan.md | 38 +++++++++ .../review.md | 39 +++++++++ docs/CREATE_PLUGIN.md | 5 -- plugins/aidd-context/CATALOG.md | 12 --- plugins/aidd-context/README.md | 16 ++-- .../aidd-context/skills/00-onboard/README.md | 39 --------- .../aidd-context/skills/00-onboard/SKILL.md | 1 + .../skills/01-bootstrap/README.md | 59 ------------- .../skills/02-project-memory/README.md | 31 ------- .../skills/03-context-generate/README.md | 24 ------ .../skills/04-skill-generate/README.md | 21 ----- .../skills/05-rule-generate/README.md | 19 ----- .../skills/06-agent-generate/README.md | 18 ---- .../skills/07-command-generate/README.md | 18 ---- .../aidd-context/skills/09-mermaid/README.md | 29 ------- .../aidd-context/skills/10-learn/README.md | 43 ---------- .../aidd-context/skills/11-explore/README.md | 31 ------- plugins/aidd-context/skills/12-cook/README.md | 12 --- plugins/aidd-dev/CATALOG.md | 11 --- plugins/aidd-dev/README.md | 20 ++--- plugins/aidd-dev/skills/00-sdlc/README.md | 68 --------------- plugins/aidd-dev/skills/01-plan/README.md | 45 ---------- .../aidd-dev/skills/02-implement/README.md | 45 ---------- plugins/aidd-dev/skills/03-assert/README.md | 58 ------------- plugins/aidd-dev/skills/04-audit/README.md | 66 --------------- plugins/aidd-dev/skills/05-review/README.md | 69 --------------- plugins/aidd-dev/skills/06-test/README.md | 56 ------------- plugins/aidd-dev/skills/07-refactor/README.md | 72 ---------------- plugins/aidd-dev/skills/08-debug/README.md | 58 ------------- plugins/aidd-dev/skills/09-for-sure/README.md | 66 --------------- plugins/aidd-dev/skills/10-todo/README.md | 19 ----- plugins/aidd-orchestrator/CATALOG.md | 1 - plugins/aidd-orchestrator/README.md | 4 +- .../skills/00-async-dev/README.md | 54 ------------ plugins/aidd-pm/CATALOG.md | 4 - plugins/aidd-pm/README.md | 8 +- .../aidd-pm/skills/01-ticket-info/README.md | 52 ------------ .../aidd-pm/skills/02-user-stories/README.md | 58 ------------- plugins/aidd-pm/skills/03-prd/README.md | 52 ------------ plugins/aidd-pm/skills/04-spec/README.md | 60 ------------- plugins/aidd-refine/CATALOG.md | 5 -- plugins/aidd-refine/README.md | 10 +-- .../skills/01-brainstorm/README.md | 32 ------- .../aidd-refine/skills/02-challenge/README.md | 57 ------------- .../aidd-refine/skills/03-condense/README.md | 64 -------------- .../skills/04-shadow-areas/README.md | 69 --------------- .../skills/05-fact-check/README.md | 69 --------------- plugins/aidd-ui/CATALOG.md | 1 - plugins/aidd-ui/README.md | 2 +- plugins/aidd-ui/skills/01-hello/README.md | 29 ------- plugins/aidd-ui/skills/01-hello/SKILL.md | 4 + plugins/aidd-vcs/CATALOG.md | 5 -- plugins/aidd-vcs/README.md | 8 +- .../aidd-vcs/skills/00-repo-init/README.md | 34 -------- plugins/aidd-vcs/skills/00-repo-init/SKILL.md | 6 ++ plugins/aidd-vcs/skills/01-commit/README.md | 53 ------------ .../aidd-vcs/skills/02-pull-request/README.md | 55 ------------ .../aidd-vcs/skills/03-release-tag/README.md | 54 ------------ .../aidd-vcs/skills/04-issue-create/README.md | 54 ------------ 61 files changed, 253 insertions(+), 1890 deletions(-) create mode 100644 aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-1.md create mode 100644 aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-2.md create mode 100644 aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/plan.md create mode 100644 aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/review.md delete mode 100644 plugins/aidd-context/skills/00-onboard/README.md delete mode 100644 plugins/aidd-context/skills/01-bootstrap/README.md delete mode 100644 plugins/aidd-context/skills/02-project-memory/README.md delete mode 100644 plugins/aidd-context/skills/03-context-generate/README.md delete mode 100644 plugins/aidd-context/skills/04-skill-generate/README.md delete mode 100644 plugins/aidd-context/skills/05-rule-generate/README.md delete mode 100644 plugins/aidd-context/skills/06-agent-generate/README.md delete mode 100644 plugins/aidd-context/skills/07-command-generate/README.md delete mode 100644 plugins/aidd-context/skills/09-mermaid/README.md delete mode 100644 plugins/aidd-context/skills/10-learn/README.md delete mode 100644 plugins/aidd-context/skills/11-explore/README.md delete mode 100644 plugins/aidd-context/skills/12-cook/README.md delete mode 100644 plugins/aidd-dev/skills/00-sdlc/README.md delete mode 100644 plugins/aidd-dev/skills/01-plan/README.md delete mode 100644 plugins/aidd-dev/skills/02-implement/README.md delete mode 100644 plugins/aidd-dev/skills/03-assert/README.md delete mode 100644 plugins/aidd-dev/skills/04-audit/README.md delete mode 100644 plugins/aidd-dev/skills/05-review/README.md delete mode 100644 plugins/aidd-dev/skills/06-test/README.md delete mode 100644 plugins/aidd-dev/skills/07-refactor/README.md delete mode 100644 plugins/aidd-dev/skills/08-debug/README.md delete mode 100644 plugins/aidd-dev/skills/09-for-sure/README.md delete mode 100644 plugins/aidd-dev/skills/10-todo/README.md delete mode 100644 plugins/aidd-orchestrator/skills/00-async-dev/README.md delete mode 100644 plugins/aidd-pm/skills/01-ticket-info/README.md delete mode 100644 plugins/aidd-pm/skills/02-user-stories/README.md delete mode 100644 plugins/aidd-pm/skills/03-prd/README.md delete mode 100644 plugins/aidd-pm/skills/04-spec/README.md delete mode 100644 plugins/aidd-refine/skills/01-brainstorm/README.md delete mode 100644 plugins/aidd-refine/skills/02-challenge/README.md delete mode 100644 plugins/aidd-refine/skills/03-condense/README.md delete mode 100644 plugins/aidd-refine/skills/04-shadow-areas/README.md delete mode 100644 plugins/aidd-refine/skills/05-fact-check/README.md delete mode 100644 plugins/aidd-ui/skills/01-hello/README.md delete mode 100644 plugins/aidd-vcs/skills/00-repo-init/README.md delete mode 100644 plugins/aidd-vcs/skills/01-commit/README.md delete mode 100644 plugins/aidd-vcs/skills/02-pull-request/README.md delete mode 100644 plugins/aidd-vcs/skills/03-release-tag/README.md delete mode 100644 plugins/aidd-vcs/skills/04-issue-create/README.md diff --git a/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-1.md b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-1.md new file mode 100644 index 00000000..2f0b0fee --- /dev/null +++ b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-1.md @@ -0,0 +1,84 @@ +--- +status: done +--- + +# Instruction: Remove per-skill READMEs and fix every reference + +## Architecture projection + +> ✅ create · ✏️ modify · ❌ delete + +```txt +. +├── plugins/ +│ ├── aidd-context/ +│ │ ├── README.md ✏️ retarget 13 skill-table links -> SKILL.md +│ │ ├── CATALOG.md ✏️ regenerate (auto) +│ │ └── skills/*/README.md ❌ delete 13 (NOT assets/**/README.md) +│ ├── aidd-dev/ +│ │ ├── README.md ✏️ retarget 11 skill-table links -> SKILL.md +│ │ ├── CATALOG.md ✏️ regenerate (auto) +│ │ └── skills/*/README.md ❌ delete 11 +│ ├── aidd-orchestrator/{README,CATALOG}.md ✏️ retarget / regenerate +│ │ └── skills/00-async-dev/README.md ❌ delete 1 +│ ├── aidd-pm/{README,CATALOG}.md ✏️ retarget / regenerate +│ │ └── skills/*/README.md ❌ delete 4 +│ ├── aidd-refine/{README,CATALOG}.md ✏️ retarget / regenerate +│ │ └── skills/*/README.md ❌ delete 5 +│ ├── aidd-ui/{README,CATALOG}.md ✏️ retarget / regenerate +│ │ └── skills/01-hello/README.md ❌ delete 1 +│ └── aidd-vcs/{README,CATALOG}.md ✏️ retarget / regenerate +│ └── skills/*/README.md ❌ delete 4 +└── docs/CREATE_PLUGIN.md ✏️ drop per-skill README from structure + section, retarget links +``` + +Do NOT touch: `plugins/*/README.md` as skills (plugin-level, kept), the top-level framework `README.md`, or asset READMEs (`plugins/aidd-context/skills/02-project-memory/assets/README.md`, `.../assets/templates/memory/README.md`). + +## Tasks to do + +### `1)` Spot-check the 7 outlier READMEs before deleting + +> 7 READMEs lack the breadcrumb header, so they may carry prose their SKILL.md does not. Merge unique content, then delete. Do not blind-delete these. + +Outliers: `aidd-context/skills/{00-onboard,09-mermaid,10-learn,11-explore,12-cook}`, `aidd-ui/skills/01-hello`, `aidd-vcs/skills/00-repo-init`. + +1. Diff each README against its sibling SKILL.md. +2. If the README holds substantive info absent from SKILL.md (e.g. `01-hello` documents an install prerequisite / `claude --plugin-dir` invocation), fold the essential line into the SKILL.md, matching that file's terse style. +3. Pure mirrors (heading + when-to/not-to that the SKILL description already states): nothing to merge. + +### `2)` Delete the 39 per-skill READMEs + +> Direct children of a skill directory only. + +1. Remove every file matching `plugins/*/skills/*/README.md`. +2. Leave the two asset READMEs and all plugin-level / framework READMEs in place. + +### `3)` Retarget the plugin-level README skill tables + +> Each of the 7 `plugins//README.md` has a Skills table linking `skills//README.md`. Point them at `SKILL.md`. + +1. In every `plugins/*/README.md`, replace `skills//README.md` link targets with `skills//SKILL.md`. Link text and table rows stay unchanged. + +### `4)` Update `docs/CREATE_PLUGIN.md` + +> The doc prescribes a per-skill README; drop that so the convention does not reintroduce them. + +1. Remove the per-skill `README.md` entry from the structure diagram (keep the plugin-level `README.md` entry). +2. Remove or rewrite the `### skills/01-hello/README.md` section so it no longer instructs authors to ship a per-skill README; keep the plugin-level README guidance. +3. Retarget any `skills//README.md` link in the doc to `SKILL.md`. + +### `5)` Regenerate the CATALOGs + +> `CATALOG.md` is auto-generated; do not hand-edit. Regenerate so the README rows drop out. + +1. For each plugin run `node scripts/summarize-markdown.js "plugins//" "plugins//CATALOG.md" --depth=4 --fields=description --title=" catalog" --tagline="Auto-generated index of skills, agents, references and assets shipped by the \`\` plugin."` (identical to the `lefthook.yml` block), or let the pre-commit hook run it. + +## Test acceptance criteria + +| Task | Acceptance criteria | +| ---- | ----------------------------------------------------------------------------------------------------------- | +| 1 | Each outlier's unique content is either merged into its SKILL.md or confirmed to be a pure mirror. | +| 2 | `find plugins -path '*/skills/*/README.md'` returns zero results; both asset READMEs still exist. | +| 3 | No `plugins/*/README.md` skill table links to a `skills/*/README.md`; all point to `SKILL.md`. | +| 4 | `docs/CREATE_PLUGIN.md` no longer prescribes a per-skill README and links to no removed file. | +| 5 | Regenerated `CATALOG.md` files list no `skills/*/README.md` row. | diff --git a/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-2.md b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-2.md new file mode 100644 index 00000000..1bea9b05 --- /dev/null +++ b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/phase-2.md @@ -0,0 +1,47 @@ +--- +status: done +--- + +# Instruction: Verify and guard + +## Architecture projection + +> No file changes; this phase runs the gates that prove the QA holds. + +```txt +. +└── (verification only — scripts/check-markdown-links.js, sync scripts) +``` + +## Tasks to do + +### `1)` Broken-link gate (the QA#3 proof) + +> Every markdown link that resolved to a now-deleted README must be gone. + +1. Run `node scripts/check-markdown-links.js` from the repo root. It resolves relative links across all markdown; a dangling link to a removed README fails it. +2. Fix any residual dangling reference it reports (retarget to `SKILL.md` or drop), then re-run until clean. + +### `2)` No per-skill README, no orphan skill + +1. `find plugins -path '*/skills/*/README.md'` returns nothing. +2. Every skill directory that lost its README still has a `SKILL.md` (no orphaned skill dir). +3. The two asset READMEs and all plugin-level / framework READMEs remain. + +### `3)` Generated artifacts consistent + +1. `node scripts/sync-readme-counts.mjs --check` exits 0 (top-level counts unaffected). +2. Regenerated CATALOGs contain no `skills/*/README.md` rows. + +### `4)` Durability + +1. Confirm `aidd-context/04-skill-generate` does not scaffold a per-skill README (a newly generated skill would not reintroduce one). + +## Test acceptance criteria + +| Task | Acceptance criteria | +| ---- | -------------------------------------------------------------------------------------- | +| 1 | `node scripts/check-markdown-links.js` exits 0 with no dangling README link reported. | +| 2 | Zero `skills/*/README.md`; every affected skill dir still has `SKILL.md`; asset READMEs intact. | +| 3 | `sync-readme-counts.mjs --check` exits 0; no CATALOG lists a per-skill README. | +| 4 | The skill generator emits no per-skill README. | diff --git a/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/plan.md b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/plan.md new file mode 100644 index 00000000..ebcfcdf2 --- /dev/null +++ b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/plan.md @@ -0,0 +1,38 @@ +--- +objective: "Every per-skill README.md that mirrors its SKILL.md is gone, and no link, doc, or generator points at a removed file." +status: reviewed +--- + +# Plan: Remove per-skill README.md + +## Overview + +| Field | Value | +| ---------- | --------------------------------------------------------------------- | +| **Goal** | Delete the 39 per-skill `README.md` mirrors; keep navigation intact. | +| **Source** | GitHub issue #302 (ai-driven-dev/framework) | + +## Phases + +| # | Phase | File | +| --- | ---------------------------- | ---------------------------- | +| 1 | Remove READMEs, fix all refs | [`phase-1.md`](./phase-1.md) | +| 2 | Verify and guard | [`phase-2.md`](./phase-2.md) | + +## Resources + +| Source | Verified | +| --------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| GitHub issue #302 | Objective + QA acceptance criteria; symlink is optional and droppable. | +| `lefthook.yml` | Pre-commit runs `check-markdown-links.js` (link gate), regenerates every `CATALOG.md`, and syncs `README.md` counts. | +| `scripts/summarize-markdown.js` | `CATALOG.md` is fully auto-generated from the file tree; deleted READMEs vanish on regen. | +| `scripts/sync-readme-counts.mjs` | Counts skills by directory, README-independent; only touches the top-level `README.md`. | +| `plugins/aidd-context/skills/04-skill-generate/*` | Does not scaffold a per-skill README; removal is durable for future skills. | + +## Decisions + +| Decision | Why | +| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| Delete the READMEs, do not symlink to SKILL.md | Plugin ships cross-OS (symlink fragile); a symlink would render SKILL.md's raw YAML frontmatter on GitHub; issue accepts clean removal. | +| Retarget plugin-README skill-table links to SKILL.md | Preserves folder navigation after the README is gone; these tables are hand-written, not generated. | +| Regenerate CATALOG.md, never hand-edit it | `CATALOG.md` is auto-generated; hand edits are overwritten by the pre-commit hook. | diff --git a/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/review.md b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/review.md new file mode 100644 index 00000000..5a55ab31 --- /dev/null +++ b/aidd_docs/tasks/2026_07/2026_07_06_remove-per-skill-readme/review.md @@ -0,0 +1,39 @@ +# Review: Remove per-skill README.md + +- **Verdict**: approve +- **Diff**: `484928c...9b327eb` +- **Axes run**: code, functional, relevancy +- **Date**: 2026_07_06 +- **Findings**: 0 critical, 0 warning, 1 minor + +## Phases + +### Phase 1 — Remove READMEs, fix all refs + +- [x] Task 1: each outlier's unique content merged into SKILL.md or confirmed a pure mirror — 00-onboard/SKILL.md:36 (Requires folded), 01-hello/SKILL.md:19-21 (prereq folded), 00-repo-init/SKILL.md:9,30-33 (status + prereq folded); 09-mermaid/10-learn/11-explore/12-cook confirmed pure mirrors (prereq already in SKILL.md) +- [x] Task 2: no direct-child `skills/*/README.md` remains; both asset READMEs present — direct-child loop returns nothing; `plugins/aidd-context/skills/02-project-memory/assets/README.md` + `.../assets/templates/memory/README.md` intact +- [x] Task 3: no `plugins/*/README.md` skill table links to `skills/*/README.md`; all point to SKILL.md — grep of `plugins/*/README.md` returns none; aidd-orchestrator/README.md:19,21 retargeted +- [x] Task 4: `docs/CREATE_PLUGIN.md` no longer prescribes a per-skill README, links to no removed file — docs/CREATE_PLUGIN.md:41,94 (structure line + section removed) +- [x] Task 5: regenerated CATALOG.md files list no `skills/*/README.md` row — grep returns only the retained asset README row (aidd-context/CATALOG.md:81), not a per-skill mirror + +### Phase 2 — Verify and guard + +- [x] Task 1: `node scripts/check-markdown-links.js` exits 0, no dangling README link — "Links: 0 broken in 364 files", exit 0 +- [x] Task 2: zero direct-child `skills/*/README.md`; every affected skill dir keeps SKILL.md; asset READMEs intact — orphan loop returns nothing; asset READMEs present +- [x] Task 3: `sync-readme-counts.mjs --check` exits 0; no CATALOG lists a per-skill README — exit 0; CATALOG regen produced zero drift (proves generated, not hand-edited) +- [x] Task 4: skill generator emits no per-skill README — `grep -rniE readme plugins/aidd-context/skills/04-skill-generate/` returns nothing; templates scaffold SKILL.md + actions only + +## Findings + +| Sev | Kind | Phase | Location | Issue | Fix | +| --- | ---- | ----- | -------- | ----- | --- | +| 🟢 | rot | 1 | plugins/aidd-context/skills/09-mermaid/SKILL.md | Deleted README's `## Requires` elaborated the input as "a paragraph, a list, or a section"; SKILL.md keeps the essential "written source" (description + Actions input) but drops that parenthetical granularity. Judged a pure mirror; noted for completeness. | Optional: none required — essential prerequisite is preserved. | + +## Verification + +| Metric | Value | +| ------------- | ------------------------------------------------- | +| Verified | 100% (9/9) | +| Files checked | 39 deleted skill READMEs, 7 plugin READMEs, 7 CATALOG.md, 3 SKILL.md merges (00-onboard, 01-hello, 00-repo-init), docs/CREATE_PLUGIN.md, plugins/aidd-context/skills/04-skill-generate/* | +| Unchecked | none | +| Unplanned | none (60 files = 39 deletions + 3 plan docs added + 18 modified; exactly scoped, no creep) | diff --git a/docs/CREATE_PLUGIN.md b/docs/CREATE_PLUGIN.md index dce4d5b6..c442692e 100644 --- a/docs/CREATE_PLUGIN.md +++ b/docs/CREATE_PLUGIN.md @@ -41,7 +41,6 @@ plugins/aidd-example/ ├── skills/ │ └── 01-hello/ │ ├── SKILL.md -│ ├── README.md │ └── actions/ │ └── 01-greet.md ├── agents/ # optional @@ -95,10 +94,6 @@ description: One-sentence summary. Use when ... Do NOT use for ... Run action `01-greet` and return its message. ``` -### `skills/01-hello/README.md` - -Mirror the sibling pattern: title, paragraph, When to use, When NOT to use, How to invoke, Outputs, Prerequisites, Technical details (link to SKILL.md). ~30-50 lines. - ### `skills/01-hello/actions/01-greet.md` ```markdown diff --git a/plugins/aidd-context/CATALOG.md b/plugins/aidd-context/CATALOG.md index f19f7334..78647903 100644 --- a/plugins/aidd-context/CATALOG.md +++ b/plugins/aidd-context/CATALOG.md @@ -48,7 +48,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-report.md](skills/00-onboard/actions/02-report.md) | - | | `actions` | [03-run.md](skills/00-onboard/actions/03-run.md) | - | | `assets` | [report.md](skills/00-onboard/assets/report.md) | - | -| `-` | [README.md](skills/00-onboard/README.md) | - | | `references` | [checks.md](skills/00-onboard/references/checks.md) | - | | `references` | [run-tiers.md](skills/00-onboard/references/run-tiers.md) | - | | `-` | [SKILL.md](skills/00-onboard/SKILL.md) | `Scan an AIDD project into a diagnostic of what is set up and missing, then run the recommended next commands in order. Use when the user asks where to start, what to do next, how the project stands, or to onboard onto AIDD. Not for listing every installed surface.` | @@ -64,7 +63,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [05-write-install-md.md](skills/01-bootstrap/actions/05-write-install-md.md) | - | | `assets` | [checklist.md](skills/01-bootstrap/assets/checklist.md) | - | | `assets` | [install-template.md](skills/01-bootstrap/assets/install-template.md) | - | -| `-` | [README.md](skills/01-bootstrap/README.md) | - | | `references` | [stack-heuristics.md](skills/01-bootstrap/references/stack-heuristics.md) | - | | `-` | [SKILL.md](skills/01-bootstrap/SKILL.md) | `Design and validate a new SaaS's architecture into an INSTALL.md via Q&A and stack comparison. Use when the user starts a project, chooses a stack, or picks an architecture pattern. Not for editing an existing stack or scaffolding code.` | @@ -81,7 +79,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `assets` | [CONTRIBUTING.md](skills/02-project-memory/assets/CONTRIBUTING.md) | - | | `assets` | [GUIDELINES.md](skills/02-project-memory/assets/GUIDELINES.md) | - | | `assets` | [README.md](skills/02-project-memory/assets/README.md) | - | -| `-` | [README.md](skills/02-project-memory/README.md) | - | | `references` | [capability-signals.md](skills/02-project-memory/references/capability-signals.md) | - | | `references` | [mapping-ai-context-file.md](skills/02-project-memory/references/mapping-ai-context-file.md) | - | | `references` | [memory-block.md](skills/02-project-memory/references/memory-block.md) | - | @@ -91,7 +88,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | File | Description | |------|---| -| [README.md](skills/03-context-generate/README.md) | - | | [SKILL.md](skills/03-context-generate/SKILL.md) | `Route a request to generate a context artifact (skill, rule, agent, command, or hook) to its generator when the kind is unnamed. A named kind triggers its generator directly. Not for listing existing artifacts.` | #### `skills/04-skill-generate` @@ -105,7 +101,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [05-validate.md](skills/04-skill-generate/actions/05-validate.md) | - | | `assets` | [action-template.md](skills/04-skill-generate/assets/action-template.md) | - | | `assets` | [skill-template.md](skills/04-skill-generate/assets/skill-template.md) | `. Use when the user wants to . " in plain words when a sibling could mis-trigger.> (Two lines max, ~240 chars, straight to the point. Third person, no XML. Never name another skill, never write a /command token. All "when" lives here, not in the body.)` | -| `-` | [README.md](skills/04-skill-generate/README.md) | - | | `references` | [skill-authoring.md](skills/04-skill-generate/references/skill-authoring.md) | - | | `references` | [tool-paths.md](skills/04-skill-generate/references/tool-paths.md) | - | | `-` | [SKILL.md](skills/04-skill-generate/SKILL.md) | `Generate a router-based skill across the host AI tools a project uses. Use when the user wants to create, scaffold, or refactor a skill, or turn a workflow into one. Not for other artifacts like rules, agents, commands, hooks.` | @@ -118,7 +113,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-write-rule.md](skills/05-rule-generate/actions/02-write-rule.md) | - | | `actions` | [03-validate.md](skills/05-rule-generate/actions/03-validate.md) | - | | `assets` | [rule-template.md](skills/05-rule-generate/assets/rule-template.md) | - | -| `-` | [README.md](skills/05-rule-generate/README.md) | - | | `references` | [rule-authoring.md](skills/05-rule-generate/references/rule-authoring.md) | - | | `references` | [tool-paths.md](skills/05-rule-generate/references/tool-paths.md) | - | | `-` | [SKILL.md](skills/05-rule-generate/SKILL.md) | `Generate a coding rule that governs editor and agent behavior across the host AI tools. Use when the user wants to write, add, or refactor a rule, convention, or coding standard. Not for other artifacts like skills, agents, or hooks.` | @@ -131,7 +125,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-write-agent.md](skills/06-agent-generate/actions/02-write-agent.md) | - | | `actions` | [03-validate.md](skills/06-agent-generate/actions/03-validate.md) | - | | `assets` | [agent-template.md](skills/06-agent-generate/assets/agent-template.md) | ` # required, third person` | -| `-` | [README.md](skills/06-agent-generate/README.md) | - | | `references` | [agent-authoring.md](skills/06-agent-generate/references/agent-authoring.md) | - | | `references` | [tool-paths.md](skills/06-agent-generate/references/tool-paths.md) | - | | `-` | [SKILL.md](skills/06-agent-generate/SKILL.md) | `Generate an agent across the host AI tools a project uses. Use when the user wants to create, scaffold, or refactor an agent, subagent or specialized role. Not for other artifacts like skills, rules, commands, hooks.` | @@ -144,7 +137,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-write-command.md](skills/07-command-generate/actions/02-write-command.md) | - | | `actions` | [03-validate.md](skills/07-command-generate/actions/03-validate.md) | - | | `assets` | [command-template.md](skills/07-command-generate/assets/command-template.md) | - | -| `-` | [README.md](skills/07-command-generate/README.md) | - | | `references` | [command-authoring.md](skills/07-command-generate/references/command-authoring.md) | - | | `references` | [tool-paths.md](skills/07-command-generate/references/tool-paths.md) | - | | `-` | [SKILL.md](skills/07-command-generate/SKILL.md) | `Generate a flat slash command across the host AI tools a project uses. Use when the user wants to create, scaffold, or refactor a one-shot slash command. Not for multi-step skills or other artifacts like rules, agents, hooks.` | @@ -167,7 +159,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | Group | File | Description | |-------|------|---| | `actions` | [01-mermaid.md](skills/09-mermaid/actions/01-mermaid.md) | - | -| `-` | [README.md](skills/09-mermaid/README.md) | - | | `references` | [mermaid-conventions.md](skills/09-mermaid/references/mermaid-conventions.md) | - | | `-` | [SKILL.md](skills/09-mermaid/SKILL.md) | `Generate a valid Mermaid diagram from a written source through a plan, generate, review loop. Use when the user wants to turn an architecture, lifecycle, or flow into a Mermaid diagram. Not for other diagram formats or image rendering.` | @@ -180,7 +171,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [03-write.md](skills/10-learn/actions/03-write.md) | - | | `actions` | [04-sync.md](skills/10-learn/actions/04-sync.md) | - | | `assets` | [decision-template.md](skills/10-learn/assets/decision-template.md) | - | -| `-` | [README.md](skills/10-learn/README.md) | - | | `-` | [SKILL.md](skills/10-learn/SKILL.md) | `Capture durable project learnings from the conversation or git history into memory, a record, a rule, or a skill. Use when the user asks to capture, record, or remember a decision or lesson. Not for AI preferences or already-captured items.` | #### `skills/11-explore` @@ -189,7 +179,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai |-------|------|---| | `actions` | [01-survey.md](skills/11-explore/actions/01-survey.md) | - | | `actions` | [02-drill.md](skills/11-explore/actions/02-drill.md) | - | -| `-` | [README.md](skills/11-explore/README.md) | - | | `references` | [ai-mapping.md](skills/11-explore/references/ai-mapping.md) | - | | `-` | [SKILL.md](skills/11-explore/SKILL.md) | `Explore the current project across its tooling, context, and codebase. Use to survey what is installed, see what is available, or find which skill, agent, or rule fits a goal. Not for choosing the next step or running an item; it only points.` | @@ -200,6 +189,5 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-list.md](skills/12-cook/actions/01-list.md) | - | | `actions` | [02-upsert.md](skills/12-cook/actions/02-upsert.md) | - | | `assets` | [recipe-template.md](skills/12-cook/assets/recipe-template.md) | - | -| `-` | [README.md](skills/12-cook/README.md) | - | | `-` | [SKILL.md](skills/12-cook/SKILL.md) | `Manage the project's recipes and how-to sheets. List them as a table, or create and update one from the canonical template. Use when the user wants to list, create, update, or cook a recipe.` | diff --git a/plugins/aidd-context/README.md b/plugins/aidd-context/README.md index 753825bd..fab12ea3 100644 --- a/plugins/aidd-context/README.md +++ b/plugins/aidd-context/README.md @@ -14,14 +14,14 @@ Covers project bootstrap, the project memory bank, generation of context artifac | Bracket ID | Skill | Description | | ---------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [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. | -| [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. | -| [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. | -| [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. | -| [1.4] | [mermaid](skills/09-mermaid/README.md) | Generate high-quality Mermaid diagrams from markdown content using a structured plan-validate workflow. | -| [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. | -| [1.6] | [explore](skills/11-explore/README.md) | Survey the project across three axes (tooling, context, codebase), then drill into one axis and point to the best-matching item for a goal. | -| [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. | +| [1.0] | [onboard](skills/00-onboard/SKILL.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. | +| [1.1] | [bootstrap](skills/01-bootstrap/SKILL.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. | +| [1.2] | [project-memory](skills/02-project-memory/SKILL.md) | Initialize or refresh the project memory bank from a capability-based model, and carry the memory block into the AI context files. | +| [1.3] | [context-generate](skills/03-context-generate/SKILL.md) | Generate context artifacts: router-based skills, agents, rules, slash commands, hooks, plugin scaffolds, and plugin marketplaces. | +| [1.4] | [mermaid](skills/09-mermaid/SKILL.md) | Generate high-quality Mermaid diagrams from markdown content using a structured plan-validate workflow. | +| [1.5] | [learn](skills/10-learn/SKILL.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. | +| [1.6] | [explore](skills/11-explore/SKILL.md) | Survey the project across three axes (tooling, context, codebase), then drill into one axis and point to the best-matching item for a goal. | +| [1.7] | [cook](skills/12-cook/SKILL.md) | Maintain the project's `recipes/` how-to sheets: list every recipe, or create and update one from the canonical recipe template. | ## Onboarding diff --git a/plugins/aidd-context/skills/00-onboard/README.md b/plugins/aidd-context/skills/00-onboard/README.md deleted file mode 100644 index 0ecc2e53..00000000 --- a/plugins/aidd-context/skills/00-onboard/README.md +++ /dev/null @@ -1,39 +0,0 @@ -← [framework](../../../../README.md) / [aidd-context](../../README.md) - -# 00 - Onboard - -A linter for an AIDD project. It scans the working directory against the framework, reports what is present, drifting, or missing as an explicit `✅ ⚠️ ❌` checklist, and hands back a single ordered list of the exact commands to run next. Reply `OK` and it walks the whole list for you, pausing at each step that needs your input. - -## When to use - -- "Where do I start?" / "Onboard me to this project." -- "What should I do next?" -- "How does this project stand against AIDD?" -- After a partial setup, to see what is still missing. - -## When not to use - -- To list every installed surface. Use the explore skill in this plugin. -- To run a specific command you already know. Invoke it directly. - -## Flow - -Three actions, in a loop: - -1. `scan`: **silently** read the project once into a snapshot of every check across four zones. Prints nothing. -2. `report`: render the loud diagnostic plus one ordered command list, foundations first, then the dev flow, each line naming a concrete installed command and its run tier. -3. `run`: carry out the reply. `OK` walks the whole list, running the unattended steps and pausing at each interactive one; a number runs one step; then re-scan and refresh. - -It scans four zones: AIDD context (memory, the `` block, architecture), context-gen artifacts (rules, agents, skills, hooks, commands), the dev flow (code, tests, spec or plan, PR), and health (bug markers, messy code). A check is met by a disk fact and flagged `⚠` on form drift. It never checks a plugin version against a registry. - -## Run tiers - -Each recommended step is one of three: **AUTO** (spawn and run to completion), **GUIDED** (an interactive skill onboard launches and hands to you), or **MANUAL** (a side-effecting command it shows but never runs). `OK` walks all three in order, running AUTO steps, pausing at each GUIDED step for your input, and leaving MANUAL commands for you to run. - -## Requires - -Only the `aidd-context` plugin installed and enabled, and a working directory rooted in the target project. The `aidd_docs/` memory bank is **not** required: on a project without it, the first recommendation is to set it up. Onboard is the entry point, so it works before anything else exists. - -## Details - -See [`SKILL.md`](SKILL.md) for the action contract and [`actions/`](actions/) for the three actions. The catalogue lives in [`references/checks.md`](references/checks.md) (the four zones and their checks) and [`references/run-tiers.md`](references/run-tiers.md) (the tiers and the `OK` chain); the report shape is [`assets/report.md`](assets/report.md). diff --git a/plugins/aidd-context/skills/00-onboard/SKILL.md b/plugins/aidd-context/skills/00-onboard/SKILL.md index 59ab1e93..76bc2e2a 100644 --- a/plugins/aidd-context/skills/00-onboard/SKILL.md +++ b/plugins/aidd-context/skills/00-onboard/SKILL.md @@ -33,6 +33,7 @@ Run `01 → 02 → 03`, then loop back to `01` after each run until the user sto - Name real commands only. Never name a command whose skill `01` did not find installed; name a missing one as a gap by function. - Never run a GUIDED step unattended, and never test a plugin version against a registry. - Re-scan after a run, never trust a stale status. Wait for an explicit reply before running anything. +- Requires only the `aidd-context` plugin installed and a working directory rooted in the target project. The `aidd_docs/` memory bank is not a prerequisite: on a project without it, the first recommendation is to set it up. Onboard is the entry point, so it works before anything else exists. Detail lives in the references: the check catalogue and ranking in `checks.md`, the run tiers and `OK` walk in `run-tiers.md`, the render shape and glyphs in `assets/report.md`. diff --git a/plugins/aidd-context/skills/01-bootstrap/README.md b/plugins/aidd-context/skills/01-bootstrap/README.md deleted file mode 100644 index 15ae57b0..00000000 --- a/plugins/aidd-context/skills/01-bootstrap/README.md +++ /dev/null @@ -1,59 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 01 - Bootstrap - -Plays the role of technical architect for a new SaaS project. Walks the user -through a 24-item checklist, proposes 2-3 candidate stacks, audits each via -parallel agents, then produces `aidd_docs/INSTALL.md` capturing the technical -vision, decisions, stack, architecture pattern, folder tree, and install -steps. Documentation only - no code, no scaffolding. - -## When to use - -- Starting a brand-new SaaS project and choosing a stack. -- Deciding the architecture pattern (monolith vs microservices vs serverless). -- Producing a project's `INSTALL.md` from a fresh idea. - -## When NOT to use - -- To edit an existing project's stack (the audit is too heavy for one - swap-out). -- For database schema design or detailed data modeling. -- To scaffold actual files - this skill produces docs only. - -## How to invoke - -``` -Use skill aidd-context:01-bootstrap -``` - -The skill walks 5 atomic actions in sequence: - -1. `gather-needs` - Q&A across the 24-item checklist (18 user-input, 6 - derived). -2. `propose-candidates` - derive 2-3 candidate stacks and render a - comparison table. -3. `audit-candidates` - spawn parallel agents to validate each candidate - and emit a verdict; if every candidate fails, loop back to `02` or `01`. -4. `pick-and-design` - user picks the winner, then generate the folder tree - and a Mermaid architecture diagram. -5. `write-install-md` - produce `aidd_docs/INSTALL.md`. - -## Outputs - -- `aidd_docs/INSTALL.md` capturing vision, decisions, chosen stack, - architecture pattern, folder tree, install steps, and a Mermaid diagram. - -## Prerequisites - -- A clear (or at least loosely-formed) product idea to discuss. -- A working directory where `aidd_docs/INSTALL.md` can be written. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, [`actions/`](actions/) -for each step, `references/stack-heuristics.md` for the input → recommended -stack-family heuristics, and `assets/checklist.md` + `assets/install-template.md` -for the canonical 24-item checklist and `INSTALL.md` skeleton. The Mermaid -architecture diagram in action 04 is rendered via the sibling -`09-mermaid` skill. diff --git a/plugins/aidd-context/skills/02-project-memory/README.md b/plugins/aidd-context/skills/02-project-memory/README.md deleted file mode 100644 index e39929b4..00000000 --- a/plugins/aidd-context/skills/02-project-memory/README.md +++ /dev/null @@ -1,31 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 02 - Project Memory - -Bootstraps the project's context layer: the AI context files with the `` block, the `aidd_docs/` structure, and the memory bank. - -## When to use - -- The first `aidd init` on a repo. -- A new project with no `aidd_docs/` yet. -- A re-run on an existing project to refresh missing memory files. - -## When not to use - -- Updating one memory file after it exists: use `aidd-context:10-learn`. -- Editing a single rule: edit the file directly. -- Generating a new artifact: use `aidd-context:03-context-generate`. - -## Flow - -Five actions, in order: - -1. `init-context-file`: resolve the tools, then upsert the memory block. -2. `scaffold-docs`: create the `aidd_docs/` structure. -3. `generate-memory`: detect the project's capabilities and fill the memory templates. -4. `review-memory`: review the memory files for consistency. -5. `sync-memory`: fill each memory block with references to the generated files. - -## Details - -See [`SKILL.md`](SKILL.md), [`actions/`](actions/), `references/mapping-ai-context-file.md` for the per-tool context-file path, and `assets/templates/memory/` for the memory templates. diff --git a/plugins/aidd-context/skills/03-context-generate/README.md b/plugins/aidd-context/skills/03-context-generate/README.md deleted file mode 100644 index fa358087..00000000 --- a/plugins/aidd-context/skills/03-context-generate/README.md +++ /dev/null @@ -1,24 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 03 - Context Generate - -A router. It sends a request to generate a context artifact to the dedicated generator for that kind, and holds no generation logic of its own. - -## Routing - -| Artifact | Generator | -| -------- | ---------------------------------- | -| skill | `aidd-context:04-skill-generate` | -| rule | `aidd-context:05-rule-generate` | -| agent | `aidd-context:06-agent-generate` | -| command | `aidd-context:07-command-generate` | -| hook | `aidd-context:08-hook-generate` | - -## When to use - -- The user wants to generate a context artifact but has not said which kind. - -## When not to use - -- A named kind: the dedicated generator triggers directly. -- Surveying or listing existing artifacts: use `aidd-context:11-explore`. diff --git a/plugins/aidd-context/skills/04-skill-generate/README.md b/plugins/aidd-context/skills/04-skill-generate/README.md deleted file mode 100644 index c53887ad..00000000 --- a/plugins/aidd-context/skills/04-skill-generate/README.md +++ /dev/null @@ -1,21 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 07 - skill-generate - -Build one canonical skill from intent (a SKILL.md router plus chained actions) and render it once per confirmed host tool. This skill is its own reference implementation: it obeys every rule it ships in `references/skill-authoring.md`. - -## When to use - -- The user wants to create, scaffold, or refactor a skill. -- Turn an existing workflow into a router-based skill. -- Not for other artifacts (rules, agents, commands, hooks). - -## Actions - -| # | Action | Purpose | -| --- | ----------------------------------------------------- | --------------------------------------------- | -| 01 | [capture-intent](actions/01-capture-intent.md) | Clarify intent + tools, inventory overlaps. | -| 02 | [decompose-actions](actions/02-decompose-actions.md) | Break the skill into atomic testable actions. | -| 03 | [draft-skill](actions/03-draft-skill.md) | Write the SKILL.md router. | -| 04 | [write-actions](actions/04-write-actions.md) | Write each action file from the template. | -| 05 | [validate](actions/05-validate.md) | Run each action's Test, aggregate pass/fail. | diff --git a/plugins/aidd-context/skills/05-rule-generate/README.md b/plugins/aidd-context/skills/05-rule-generate/README.md deleted file mode 100644 index a0e3b07f..00000000 --- a/plugins/aidd-context/skills/05-rule-generate/README.md +++ /dev/null @@ -1,19 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 08 - rule-generate - -Write one canonical coding rule from intent and render it once per host AI tool that supports rules. A sibling of `04-skill-generate` for the rule artifact. - -## When to use - -- The user wants to write, add, or refactor a rule, a convention, or a coding standard. -- Scan a codebase and propose rules. -- Not for other artifacts (skills, agents, commands, hooks). - -## Actions - -| # | Action | Purpose | -| --- | ----------------------------------------- | -------------------------------------------- | -| 01 | [capture-rule](actions/01-capture-rule.md) | Capture the topic, pick category and slug. | -| 02 | [write-rule](actions/02-write-rule.md) | Write the rule file per supported tool. | -| 03 | [validate](actions/03-validate.md) | Check each rule file. | diff --git a/plugins/aidd-context/skills/06-agent-generate/README.md b/plugins/aidd-context/skills/06-agent-generate/README.md deleted file mode 100644 index 8748dd26..00000000 --- a/plugins/aidd-context/skills/06-agent-generate/README.md +++ /dev/null @@ -1,18 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 06 - agent-generate - -Write one canonical subagent from intent and render it once per host AI tool, converting to each tool's shape (markdown, or Codex TOML). A sibling of `04-skill-generate` for the agent artifact. - -## When to use - -- The user wants to create, scaffold, or refactor an agent or subagent. -- Not for other artifacts (skills, rules, commands, hooks). - -## Actions - -| # | Action | Purpose | -| --- | -------------------------------------------- | ---------------------------------------------- | -| 01 | [capture-agent](actions/01-capture-agent.md) | Gather the role, propose names, pick the model. | -| 02 | [write-agent](actions/02-write-agent.md) | Render the agent per tool and write. | -| 03 | [validate](actions/03-validate.md) | Check each agent file. | diff --git a/plugins/aidd-context/skills/07-command-generate/README.md b/plugins/aidd-context/skills/07-command-generate/README.md deleted file mode 100644 index efd2bddf..00000000 --- a/plugins/aidd-context/skills/07-command-generate/README.md +++ /dev/null @@ -1,18 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-context](../../README.md) - -# 07 - command-generate - -Write one canonical slash command from intent and render it once per host AI tool that supports commands. A sibling of `04-skill-generate` for the command artifact. - -## When to use - -- The user wants to create, scaffold, or refactor a one-shot slash command. -- Not for multi-step skills (use the skill generator) or other artifacts (rules, agents, hooks). - -## Actions - -| # | Action | Purpose | -| --- | ----------------------------------------------- | ------------------------------------------ | -| 01 | [capture-command](actions/01-capture-command.md) | Capture the goal, location, and arguments. | -| 02 | [write-command](actions/02-write-command.md) | Write the command file per supported tool. | -| 03 | [validate](actions/03-validate.md) | Check each command file. | diff --git a/plugins/aidd-context/skills/09-mermaid/README.md b/plugins/aidd-context/skills/09-mermaid/README.md deleted file mode 100644 index 237a3503..00000000 --- a/plugins/aidd-context/skills/09-mermaid/README.md +++ /dev/null @@ -1,29 +0,0 @@ -← [framework](../../../../README.md) / [aidd-context](../../README.md) - -# 09 - Mermaid - -Generates a valid, high-quality Mermaid diagram from a written source through a plan, confirm, generate, review loop. - -## When to use - -- Turning a written description (architecture, lifecycle, flow) into a Mermaid diagram. -- Producing a diagram to embed in an `INSTALL.md`, a decision record, or a memory file. -- When another skill needs a diagram (for example `01-bootstrap` calls it). - -## When not to use - -- For other diagram formats (PlantUML, Graphviz, draw.io). -- To freehand a diagram without a written source to plan from. -- To render or export to an image. This skill produces fenced Mermaid text only. - -## Flow - -One action with a six-step loop: get the source, plan, confirm the plan, generate, offer a review, review on confirm. The diagram is generated only from the confirmed plan, and never adds an element the user did not confirm. - -## Requires - -A written source (a paragraph, a list, or a section) describing what to diagram. - -## Details - -See [`SKILL.md`](SKILL.md) for the contract, [`actions/01-mermaid.md`](actions/01-mermaid.md) for the process, and [`references/mermaid-conventions.md`](references/mermaid-conventions.md) for the conventions and defaults every diagram follows. diff --git a/plugins/aidd-context/skills/10-learn/README.md b/plugins/aidd-context/skills/10-learn/README.md deleted file mode 100644 index d091b63c..00000000 --- a/plugins/aidd-context/skills/10-learn/README.md +++ /dev/null @@ -1,43 +0,0 @@ -← [framework](../../../../README.md) / [aidd-context](../../README.md) - -# 10 - Learn - -Distills what a piece of work taught into the project's lasting context. It picks a source, scores each candidate learning, asks the user what to do with each one, writes only the approved lessons, and refreshes the memory block so the next session starts from them. - -## When to use - -- The user states a lasting rule or convention ("from now on", "always", "going forward"). -- A decision is made and worth recording with its rationale. -- Something is deprecated, or a piece of work is worth distilling before moving on. - -## When not to use - -- For personal or AI-preference reminders. Those belong in user memory, not the project. -- For routine edits, minor fixes, or anything already captured. -- To stand up the memory bank itself. Use `aidd-context:02-project-memory`. - -## Requires - -An existing memory bank (`aidd_docs/memory/`). If it is missing, run `aidd-context:02-project-memory` first. - -## Flow - -Four actions, in order: - -1. `gather`: pick a source (the conversation, the git history, or one the user names), collect candidates, drop the noise. -2. `assess`: score each candidate from 0 to 10 with a reason, propose a destination, and ask the user what to do with each. -3. `write`: write the lessons the user approved to their destinations. -4. `sync`: refresh the memory block in every context file. - -## Destinations - -- **Memory**: a fact or convention, into the matching memory file. -- **Decision**: a choice with a rationale, a record in `aidd_docs/memory/internal/decisions/` from `assets/decision-template.md`. -- **Rule**: a convention to enforce, handed to `aidd-context:05-rule-generate`. -- **Skill**: a reusable workflow, handed to `aidd-context:04-skill-generate`. - -The score is the brake (bar 6 of 10), and the user decides every item before anything is written. - -## Details - -See [`SKILL.md`](SKILL.md) and [`actions/`](actions/). diff --git a/plugins/aidd-context/skills/11-explore/README.md b/plugins/aidd-context/skills/11-explore/README.md deleted file mode 100644 index 7a8eb5c0..00000000 --- a/plugins/aidd-context/skills/11-explore/README.md +++ /dev/null @@ -1,31 +0,0 @@ -← [framework](../../../../README.md) / [aidd-context](../../README.md) - -# 11 - Explore - -Surveys the current project across three axes so you see what is there, then lets you dig into any of them. It maps the project, it never tells you the next step (that is onboard's job). - -## When to use - -- "What do we have here?" / "What is installed?" / "What is set up?" -- Browsing the AIDD capabilities, the context layer, or the project shape. -- Finding which skill, agent, rule, or hook fits a goal. - -## When not to use - -- For the next logical step to take. Use `aidd-context:00-onboard`. -- To run a found item. Explore points, the user invokes. -- To create a new skill, rule, or agent. Use the generators. - -## The three axes - -- **Tooling**: the installed skills, agents, commands, rules, hooks, MCP servers, and plugins. What you can run. -- **Context**: the memory bank, specs, plans, and the AI context files. What the AI knows. -- **Codebase**: the stack and the high-level structure. What the project is. - -## Flow - -It detects your AI tools first, then routes by what you asked. Name nothing and `survey` reads the three axes and presents a compact map, then proposes one axis or all. Name an axis (or all) and `drill` goes straight in. `drill` lists the level in full, recommends the single best match with its invocation path when you name a goal, and descends one level deeper on request, a skill into its actions, a memory file into its sections, until a leaf or a stop. - -## Details - -See [`SKILL.md`](SKILL.md) for the contract, [`actions/`](actions/) for the two actions, and [`references/ai-mapping.md`](references/ai-mapping.md) for the per-tool scan paths. diff --git a/plugins/aidd-context/skills/12-cook/README.md b/plugins/aidd-context/skills/12-cook/README.md deleted file mode 100644 index d4d04135..00000000 --- a/plugins/aidd-context/skills/12-cook/README.md +++ /dev/null @@ -1,12 +0,0 @@ -← [framework](../../../../README.md) / [aidd-context](../../README.md) - -# 12 - cook - -Maintain the project's `recipes/` how-to sheets: list them, or create and update one from the canonical template. The recipes are the short runbooks at the root of whatever project the skill runs in. - -| # | Action | Purpose | -| --- | ------------------------------ | ---------------------------------------------- | -| 01 | [list](actions/01-list.md) | List every recipe as a table. | -| 02 | [upsert](actions/02-upsert.md) | Create or update one recipe from the template. | - -See [`SKILL.md`](SKILL.md) for the router and [`assets/recipe-template.md`](assets/recipe-template.md) for the recipe shape. diff --git a/plugins/aidd-dev/CATALOG.md b/plugins/aidd-dev/CATALOG.md index 3841384c..399feb29 100644 --- a/plugins/aidd-dev/CATALOG.md +++ b/plugins/aidd-dev/CATALOG.md @@ -47,7 +47,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [03-implement.md](skills/00-sdlc/actions/03-implement.md) | - | | `actions` | [04-review.md](skills/00-sdlc/actions/04-review.md) | - | | `actions` | [05-ship.md](skills/00-sdlc/actions/05-ship.md) | - | -| `-` | [README.md](skills/00-sdlc/README.md) | - | | `-` | [SKILL.md](skills/00-sdlc/SKILL.md) | `Orchestrate the full dev flow, a free-form request to shipped code, every step delegated. Use to take a request end to end, not a single step. Interactive by default; say auto for unattended.` | #### `skills/01-plan` @@ -60,7 +59,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [04-plan.md](skills/01-plan/actions/04-plan.md) | - | | `assets` | [phase-template.md](skills/01-plan/assets/phase-template.md) | - | | `assets` | [plan-template.md](skills/01-plan/assets/plan-template.md) | - | -| `-` | [README.md](skills/01-plan/README.md) | - | | `references` | [plan-status.md](skills/01-plan/references/plan-status.md) | `Plan lifecycle status field - values, meaning, who writes each, and when.` | | `references` | [wireframe-conventions.md](skills/01-plan/references/wireframe-conventions.md) | - | | `-` | [SKILL.md](skills/01-plan/SKILL.md) | `Turn a request, ticket, or file into a phased implementation plan. Use to plan a feature before building, or to turn a ticket into phases. Do NOT use to write code or review a diff.` | @@ -72,7 +70,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-prepare.md](skills/02-implement/actions/01-prepare.md) | - | | `actions` | [02-execute.md](skills/02-implement/actions/02-execute.md) | - | | `actions` | [03-finalize.md](skills/02-implement/actions/03-finalize.md) | - | -| `-` | [README.md](skills/02-implement/README.md) | - | | `references` | [blocked.md](skills/02-implement/references/blocked.md) | `Conditions that make a plan blocked (needs a human).` | | `-` | [SKILL.md](skills/02-implement/SKILL.md) | `Write an existing plan's code, phase by phase, until every acceptance criterion holds. Use when a plan exists and needs implementing. Do NOT use to write a plan, review a diff.` | @@ -84,7 +81,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-assert-architecture.md](skills/03-assert/actions/02-assert-architecture.md) | - | | `actions` | [03-assert-frontend.md](skills/03-assert/actions/03-assert-frontend.md) | - | | `assets` | [task-template.md](skills/03-assert/assets/task-template.md) | - | -| `-` | [README.md](skills/03-assert/README.md) | - | | `-` | [SKILL.md](skills/03-assert/SKILL.md) | `Assert the work behaves by iterating the project's coding assertions until they pass, plus optional architecture and frontend facets. Use to validate an implementation. Not for reviewing or writing tests.` | #### `skills/04-audit` @@ -99,7 +95,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [06-tests.md](skills/04-audit/actions/06-tests.md) | - | | `actions` | [07-ui.md](skills/04-audit/actions/07-ui.md) | - | | `assets` | [audit-template.md](skills/04-audit/assets/audit-template.md) | `Codebase audit report template` | -| `-` | [README.md](skills/04-audit/README.md) | - | | `-` | [SKILL.md](skills/04-audit/SKILL.md) | `Audit a codebase read-only across seven quality pillars into one ranked report. Use when the user wants to assess, health-check, or audit a codebase or one pillar. Not for fixing findings, reviewing a change, or checking a feature works.` | #### `skills/05-review` @@ -110,7 +105,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-review-functional.md](skills/05-review/actions/02-review-functional.md) | - | | `actions` | [03-review-relevancy.md](skills/05-review/actions/03-review-relevancy.md) | - | | `assets` | [review-template.md](skills/05-review/assets/review-template.md) | - | -| `-` | [README.md](skills/05-review/README.md) | - | | `references` | [review-rubric.md](skills/05-review/references/review-rubric.md) | - | | `-` | [SKILL.md](skills/05-review/SKILL.md) | `Review a diff read-only on three axes, code, behavior versus the plan, and relevancy, into one verdict report. Use before shipping a change. Not for fixing findings or auditing a codebase.` | @@ -120,7 +114,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai |-------|------|---| | `actions` | [01-test.md](skills/06-test/actions/01-test.md) | - | | `actions` | [02-test-journey.md](skills/06-test/actions/02-test-journey.md) | - | -| `-` | [README.md](skills/06-test/README.md) | - | | `-` | [SKILL.md](skills/06-test/SKILL.md) | `Write and iterate tests until they pass, or validate a user journey end to end in the browser. Use when the user wants to add coverage, find what's untested, or walk a flow. Not for auditing test health or debugging a failure.` | #### `skills/07-refactor` @@ -131,7 +124,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-security.md](skills/07-refactor/actions/02-security.md) | - | | `actions` | [03-cleanup.md](skills/07-refactor/actions/03-cleanup.md) | - | | `actions` | [04-architecture.md](skills/07-refactor/actions/04-architecture.md) | - | -| `-` | [README.md](skills/07-refactor/README.md) | - | | `-` | [SKILL.md](skills/07-refactor/SKILL.md) | `Improve code across four axes (cleanup, performance, security, architecture) by scanning and fixing, or applying a pushed audit report. Use when the user wants to refactor, optimize, harden, or remove code. Not for read-only diagnosis or adding tests.` | #### `skills/08-debug` @@ -142,7 +134,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-debug.md](skills/08-debug/actions/02-debug.md) | - | | `actions` | [03-reflect-issue.md](skills/08-debug/actions/03-reflect-issue.md) | - | | `assets` | [task-template.md](skills/08-debug/assets/task-template.md) | `Task tracking system to ensure all tasks are categorized and addressed` | -| `-` | [README.md](skills/08-debug/README.md) | - | | `references` | [mermaid-conventions.md](skills/08-debug/references/mermaid-conventions.md) | `Rules for generating valid, high-quality Mermaid diagrams. Apply when creating or reviewing any Mermaid diagram (flowchart, state, ER, sequence, gantt).` | | `-` | [SKILL.md](skills/08-debug/SKILL.md) | `Reproduce and fix a known bug, or find an unknown root cause by hypothesis validation. Use when the user wants to fix a bug, find why something breaks, or reopen a stuck investigation. Not for building a feature or reviewing a diff.` | @@ -155,7 +146,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [03-autonomous-loop.md](skills/09-for-sure/actions/03-autonomous-loop.md) | - | | `assets` | [autonomous-loop-worker-prompt.md](skills/09-for-sure/assets/autonomous-loop-worker-prompt.md) | - | | `assets` | [plan-template.md](skills/09-for-sure/assets/plan-template.md) | - | -| `-` | [README.md](skills/09-for-sure/README.md) | - | | `references` | [autonomous-loop-log-format.md](skills/09-for-sure/references/autonomous-loop-log-format.md) | - | | `-` | [SKILL.md](skills/09-for-sure/SKILL.md) | `Run an iterative agent loop that retries until a runnable success condition passes. Use when the user says "for sure", "keep trying until", or wants guaranteed completion against a success command. Not for one-shot tasks or uncheckable goals.` | @@ -164,6 +154,5 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | Group | File | Description | |-------|------|---| | `actions` | [01-todo.md](skills/10-todo/actions/01-todo.md) | - | -| `-` | [README.md](skills/10-todo/README.md) | - | | `-` | [SKILL.md](skills/10-todo/SKILL.md) | `Split the user prompt into independent todos and run one executor agent per todo in parallel, then report a minimal table. Use when the user says "todo" or asks to fan out a multi-part request into parallel implementations.` | diff --git a/plugins/aidd-dev/README.md b/plugins/aidd-dev/README.md index 99939744..a741fe70 100644 --- a/plugins/aidd-dev/README.md +++ b/plugins/aidd-dev/README.md @@ -14,16 +14,16 @@ Covers the full SDLC coding loop: orchestrator, planning, implementation, assert | Bracket ID | Skill | Description | |---|---|---| -| [2.0] | [sdlc](skills/00-sdlc/README.md) | Dev SDLC orchestrator (code-shipping pipeline): spec, plan, implement, test, review, commit, PR. | -| [2.1] | [plan](skills/01-plan/README.md) | Turn a request, ticket, or file into a phased implementation plan, gathering the source first and optionally wireframing a screen before planning. | -| [2.2] | [implement](skills/02-implement/README.md) | Execute an implementation plan phase by phase, recipe-style, iterating until 100% completeness. | -| [2.3] | [assert](skills/03-assert/README.md) | Assert features work as intended - general assertions, architecture conformance, and frontend UI validation. | -| [2.4] | [audit](skills/04-audit/README.md) | Perform deep codebase analysis to identify technical debt, dead code, and improvement opportunities. | -| [2.5] | [review](skills/05-review/README.md) | Review a diff along three axes: code quality, feature behavior against the plan, and relevancy (fit to the need, declared-rule conformance, no rot). | -| [2.6] | [test](skills/06-test/README.md) | Write and iterate on tests until they pass, and validate user journeys end-to-end in the browser. | -| [2.7] | [refactor](skills/07-refactor/README.md) | Optimize code for performance and fix security vulnerabilities following OWASP guidelines. | -| [2.8] | [debug](skills/08-debug/README.md) | Reproduce and fix bugs systematically using test-driven workflow, root cause analysis, and hypothesis validation. | -| [2.9] | [for-sure](skills/09-for-sure/README.md) | Iterative agent loop that tracks attempts and retries until a success condition is met. | +| [2.0] | [sdlc](skills/00-sdlc/SKILL.md) | Dev SDLC orchestrator (code-shipping pipeline): spec, plan, implement, test, review, commit, PR. | +| [2.1] | [plan](skills/01-plan/SKILL.md) | Turn a request, ticket, or file into a phased implementation plan, gathering the source first and optionally wireframing a screen before planning. | +| [2.2] | [implement](skills/02-implement/SKILL.md) | Execute an implementation plan phase by phase, recipe-style, iterating until 100% completeness. | +| [2.3] | [assert](skills/03-assert/SKILL.md) | Assert features work as intended - general assertions, architecture conformance, and frontend UI validation. | +| [2.4] | [audit](skills/04-audit/SKILL.md) | Perform deep codebase analysis to identify technical debt, dead code, and improvement opportunities. | +| [2.5] | [review](skills/05-review/SKILL.md) | Review a diff along three axes: code quality, feature behavior against the plan, and relevancy (fit to the need, declared-rule conformance, no rot). | +| [2.6] | [test](skills/06-test/SKILL.md) | Write and iterate on tests until they pass, and validate user journeys end-to-end in the browser. | +| [2.7] | [refactor](skills/07-refactor/SKILL.md) | Optimize code for performance and fix security vulnerabilities following OWASP guidelines. | +| [2.8] | [debug](skills/08-debug/SKILL.md) | Reproduce and fix bugs systematically using test-driven workflow, root cause analysis, and hypothesis validation. | +| [2.9] | [for-sure](skills/09-for-sure/SKILL.md) | Iterative agent loop that tracks attempts and retries until a success condition is met. | ## Agents diff --git a/plugins/aidd-dev/skills/00-sdlc/README.md b/plugins/aidd-dev/skills/00-sdlc/README.md deleted file mode 100644 index f588e49f..00000000 --- a/plugins/aidd-dev/skills/00-sdlc/README.md +++ /dev/null @@ -1,68 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 00 - sdlc - -Pure orchestrator for the full AIDD development flow. Takes a free-form request -from idea to shipped code by composing the other skills in this plugin (and any -VCS-providing capabilities loaded at runtime, e.g. commit and pull-request). -Holds no business logic of its own; every step is delegated. - -## When to use - -- A human (or upstream orchestrator) hands over a free-form request and you - need to drive it end-to-end: spec, plan, implement, review, ship. -- You want the default run with confirmation gates (`interactive` mode). -- You want an unattended run with no human prompts (`auto` mode). - -## When NOT to use - -- A single SDLC step is enough → call that skill directly - ([01-plan](../01-plan/README.md), [02-implement](../02-implement/README.md), - [05-review](../05-review/README.md), etc.). -- You need to audit, refactor, debug, test, or assert outside of a shipping - pipeline → see [04-audit](../04-audit/README.md), - [07-refactor](../07-refactor/README.md), [08-debug](../08-debug/README.md), - [06-test](../06-test/README.md), [03-assert](../03-assert/README.md). -- The task has an explicit retry-until-success contract → use - [09-for-sure](../09-for-sure/README.md). - -## How to invoke - -``` -/sdlc # interactive (default): pauses at each gate -/sdlc auto # unattended: no human prompts -``` - -The skill walks 5 actions: - -1. `spec` - consolidate sources, draft or refine the contract (skippable if - the source ticket already carries objective + acceptance criteria). -2. `plan` - produce the mandatory plan file by running `aidd-dev:01-plan` in - the orchestrator's own context (it owns the plan). -3. `implement` - loop milestones via the `executor` agent until complete. -4. `review` - verdict `ship` or `iterate` via the `checker` agent; on - `iterate`, loop back to step 3 with findings. -5. `ship` - commit and open the pull request. - -## Outputs - -- A spec file (unless skipped). -- A plan file in `aidd_docs/tasks/`. -- Atomic commits on the active branch, one per phase. -- A pull request with title, body, base branch, and draft state. -- Findings + completion + quality scores from the checker. - -## Prerequisites - -- HEAD is on a non-default branch when the run is meant to ship. `05-ship` - aborts with `contract_violation: on_default_branch` otherwise. -- The `executor` and `checker` agents are available. -- A VCS-providing capability is loaded at runtime for the ship step - (commit + pull-request creation). - -## Technical details - -See [`SKILL.md`](SKILL.md) for the orchestration contract, the iron rule -("you are the conductor, not a player"), the mode detection logic, and the -five interactive gate definitions. Per-action contracts live in -[`actions/`](actions/). diff --git a/plugins/aidd-dev/skills/01-plan/README.md b/plugins/aidd-dev/skills/01-plan/README.md deleted file mode 100644 index 1bf79fb6..00000000 --- a/plugins/aidd-dev/skills/01-plan/README.md +++ /dev/null @@ -1,45 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 01 - plan - -Turns a request, ticket, or file into a phased implementation plan and its phase files. The plan is the single source of truth that downstream skills (`02-implement`, `05-review`) consume. - -## When to use - -- A spec, ticket, or request exists and you need a phased plan with deterministic acceptance criteria before any code change. -- A screen needs its layout fixed with a low-fidelity wireframe before the plan. - -## When NOT to use - -- You already have a plan and need to write code → use [02-implement](../02-implement/README.md). -- The task is a single fix with no planning surface → use [08-debug](../08-debug/README.md) or edit directly. -- You want spec drafting, not planning → use the project's spec-drafting capability. - -## How to invoke - -``` -Use skill aidd-dev:01-plan -``` - -The skill runs four actions in order, the plan being the culmination: - -1. `gather` collects the source the plan rests on and restates it. Always first. -2. `explore` reads the codebase for the architecture projection, the applicable rules, and feasibility. Gated with the user. -3. `wireframe` sketches a low-fidelity ASCII layout of any screen the feature needs, using the explored context. Frontend only, skipped when there is no UI. -4. `plan` breaks the work into phases and writes the plan and its phase files. - -A feature folder `aidd_docs/tasks//_/`: - -- `plan.md` from the plan template: objective, phases, resources, decisions. -- `phase-.md` per phase from the phase template: projection slice, user journey, tasks, acceptance criteria, any wireframe. - -The plan reuses the folder when the source already lives in one, so a `brainstorm.md` or `spec.md` already there sits alongside, not duplicated. - -## Prerequisites - -- A request, ticket, or file as the source. -- The plan and phase templates bundled with this skill. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action flow, [`assets/plan-template.md`](assets/plan-template.md) for the plan format, and [`actions/`](actions/) for the per-action contracts. diff --git a/plugins/aidd-dev/skills/02-implement/README.md b/plugins/aidd-dev/skills/02-implement/README.md deleted file mode 100644 index ea254931..00000000 --- a/plugins/aidd-dev/skills/02-implement/README.md +++ /dev/null @@ -1,45 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 02 - implement - -Executes an existing implementation plan phase by phase, iterating until every acceptance criterion is satisfied. Tracks status in the plan and phase frontmatter as it goes. - -## When to use - -- A plan produced by [01-plan](../01-plan/README.md) is ready and you need the code written against it. -- An iteration of [00-sdlc](../00-sdlc/README.md) delegates the implement step. - -## When NOT to use - -- No plan exists yet → use [01-plan](../01-plan/README.md) first. -- The plan is wrong and needs replanning → replan with [01-plan](../01-plan/README.md); this skill never rewrites the plan. -- A bug fix with no plan surface → use [08-debug](../08-debug/README.md). - -## How to invoke - -``` -Use skill aidd-dev:02-implement -``` - -Pass the plan path or content as the arguments. The skill runs three actions in order: - -1. **prepare**: fails fast when the plan is missing (never fabricates one); puts `HEAD` on a feature branch when it is on the default branch, otherwise keeps the current branch; sets the plan `status: in-progress`. -2. **execute**: loops the plan's phases: per phase it sets `status: in-progress` as a runtime marker, codes the phase, asserts it clean, then commits the phase and sets `status: done`; stops at `status: blocked` on a human-only condition. -3. **finalize**: runs validation, then marks the plan `status: implemented` once every phase is done. - -**Commits**: code and status are committed together, one commit per phase, plus a final `implemented` commit. The `in-progress` marks are runtime-only, so the tree is never left dirty at a phase boundary. - -## Outputs - -- Code for the feature, one phase at a time, committed on the active feature branch, one commit per phase. -- Plan and phase frontmatter status driven `pending → in-progress → done / implemented`, or `blocked`. -- A `replan needed` report when the plan no longer matches reality; this recipe never rewrites the plan. - -## Prerequisites - -- A plan file with phases and acceptance criteria, from `01-plan`. -- Project conventions honoured by whoever runs the recipe. - -## Technical details - -See [`SKILL.md`](SKILL.md) and [`actions/`](actions/) for the prepare/execute/finalize split: the branch guard, the phase loop, the assert gate, the status lifecycle, and the boundary constraints (no formatting, no dev mode). diff --git a/plugins/aidd-dev/skills/03-assert/README.md b/plugins/aidd-dev/skills/03-assert/README.md deleted file mode 100644 index 2d79a27d..00000000 --- a/plugins/aidd-dev/skills/03-assert/README.md +++ /dev/null @@ -1,58 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 03 - assert - -A gate that validates the work behaves as intended: it iterates the project's -coding assertions until they pass, with optional architecture-conformance and -running-frontend facets. Returns a pass or fail verdict. - -## When to use - -- Work is implemented and you need to assert it behaves as intended - before merging or shipping. -- You need to verify code conforms to documented architecture (ADRs, - diagrams, structure). -- A frontend change needs visual / behavioral validation in a real browser. - -## When NOT to use - -- The work isn't built yet → plan first with - [01-plan](../01-plan/README.md) and implement with - [02-implement](../02-implement/README.md). -- You want a rule-based code review → use - [05-review](../05-review/README.md). -- You're writing tests for the first time → use - [06-test](../06-test/README.md). - -## How to invoke - -``` -Use skill aidd-dev:03-assert -``` - -The skill exposes 3 facets, run together when applicable or one when named: - -1. `assert` - the coding-assertion loop; always applies. -2. `assert-architecture` - report where code breaks the documented - architecture (ADRs, diagrams, structure); report only, opt-in. -3. `assert-frontend` - drive a browser to confirm the frontend - behaves as intended; needs a running frontend (it resolves the URL). - -## Outputs - -- A pass or fail verdict on the work (this is a gate, not a stored report). -- The fixes applied by the coding and frontend facets. -- The conformance violations from the architecture facet. - -## Prerequisites - -- An explicit acceptance criterion, architecture artifact, or frontend - surface to validate against. -- A running dev server / preview when asserting frontend. -- Browser automation tooling available in the runtime for the frontend - variant. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action list. Per-action contracts live -in [`actions/`](actions/). diff --git a/plugins/aidd-dev/skills/04-audit/README.md b/plugins/aidd-dev/skills/04-audit/README.md deleted file mode 100644 index 6e534c45..00000000 --- a/plugins/aidd-dev/skills/04-audit/README.md +++ /dev/null @@ -1,66 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 04 - audit - -Read-only codebase audit across seven quality pillars. Diagnoses and ranks -findings into a structured report; it never edits code. Each finding carries -a suggested fix for a later act-skill to apply. - -## When to use - -- You want a global health check of the codebase, or a deep look at one - dimension (security, performance, dependencies, ...). -- You're preparing a refactor and need a prioritized, located list of issues. -- A new contributor (or a stale repo) needs hidden problems surfaced. - -## When NOT to use - -- A specific bug is already known → use [08-debug](../08-debug/README.md). -- You want to fix the problems → run the audit first, then an act-skill such - as [07-refactor](../07-refactor/README.md) or - [06-test](../06-test/README.md). -- You want a per-PR code review → use [05-review](../05-review/README.md). -- You want to validate a feature works → use [03-assert](../03-assert/README.md). - -## How to invoke - -``` -Use skill aidd-dev:04-audit -``` - -Run-one or run-all: - -- Name a pillar (`audit security`, `perf audit`) → one pillar. -- Ask for a full audit (`/audit`, "health check") → the skill asks "full or a - specific pillar?", then scans all applicable pillars into one merged report. - -The seven pillars: - -1. `code-quality` - clean code (naming, SOLID, DRY, smells) + tech debt. -2. `architecture` - C4 / ADR conformance, coupling, boundaries, layering. -3. `security` - OWASP, authz, input validation, secrets. -4. `dependencies` - CVEs, licenses, outdated and unused deps. -5. `performance` - N+1, hot paths, bundle size, heavy operations. -6. `tests` - critical-path coverage, flakiness, pyramid balance. -7. `ui` - states, visual hierarchy, design-system drift, responsive, a11y. - -## Outputs - -- One structured report: a findings table (severity, pillar, `file:line`, - issue, fix, effort), a ranked Top-actions list, and a Coverage section - proving which pillars were scanned (and which were skipped, with reason). - -## Prerequisites - -- Project rules and architecture docs loaded in context (the audit grades - against them). -- Read access to the codebase. -- For tool/runtime pillars (dependencies, performance, tests, ui): the - relevant tool when available; otherwise that pillar degrades or is skipped - with a recorded reason. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the routing + output contract, the -`actions/0X-.md` files for each pillar's lens and method, and -[`assets/audit-template.md`](assets/audit-template.md) for the report shape. diff --git a/plugins/aidd-dev/skills/05-review/README.md b/plugins/aidd-dev/skills/05-review/README.md deleted file mode 100644 index 96962343..00000000 --- a/plugins/aidd-dev/skills/05-review/README.md +++ /dev/null @@ -1,69 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 05 - review - -Reviews a diff along three axes: code quality (clean-code), feature behavior -against the plan's acceptance criteria, and relevancy (does the change belong: -fit to the need, declared-rule conformance, no rot). Read-only: surfaces -findings and one verdict into a single report, never edits the artifact. Runs -all three axes by default, or one when named. - -## When to use - -- A feature is implemented and you need an independent verdict before - shipping. -- A diff needs a grounded review without ad-hoc opinion. - -## When NOT to use - -- You want to assert runtime behavior, not review code → use - [03-assert](../03-assert/README.md). -- You want to fix the issues, not surface them → use - [02-implement](../02-implement/README.md) or - [07-refactor](../07-refactor/README.md) after the review. -- You want a global codebase audit, not a per-feature review → use - [04-audit](../04-audit/README.md). - -## How to invoke - -``` -Use skill aidd-dev:05-review # all three axes -Use skill aidd-dev:05-review review-relevancy # one named axis -``` - -The skill exposes 3 axes, run together by default or one when named: - -1. `review-code` - grade the diff against clean-code principles; surface - violations with file and line. -2. `review-functional` - trace the feature against the plan's phases; each - acceptance criterion a checked or unchecked box, plus a verification summary. -3. `review-relevancy` - judge whether the change belongs: fit to the need, - conformance to the project's declared rules, and no duplication or - over-engineering. - -## Outputs - -- One read-only `review.md` in the reviewed work's feature folder, beside - `plan.md`, never patches the code: - - Header: the overall verdict (`approve` / `changes-requested` / `blocked`), - scope, and findings count. - - `Phases`: plan phases with a checked or unchecked box per acceptance - criterion (functional axis). - - `Findings`: one table for every axis (🔴 / 🟡 / 🟢), Kind (`code` / `fit` / - `conform` / `rot`), a Phase column, and `file:line`; code and relevancy - append their rows here. - - `Verification`: percent verified, files checked, a tag on each unchecked - criterion, and the unplanned changes. - - Each axis runs independently, appending to the shared report. - -## Prerequisites - -- A diff or a set of changes to review. -- A plan file with explicit acceptance criteria for the functional axis. -- The project's declared rules, discovered at runtime, for the relevancy axis. - -## Technical details - -See [`SKILL.md`](SKILL.md), [`actions/`](actions/), and the report template in -[`assets/`](assets/) for the three review axes and the single report they -compose. diff --git a/plugins/aidd-dev/skills/06-test/README.md b/plugins/aidd-dev/skills/06-test/README.md deleted file mode 100644 index 452e7826..00000000 --- a/plugins/aidd-dev/skills/06-test/README.md +++ /dev/null @@ -1,56 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 06 - test - -Writes and iterates on tests until they pass, and validates user journeys -end-to-end through browser automation. Identifies untested behaviors first, -then drives test creation until quality criteria are met. - -## When to use - -- A feature has insufficient test coverage and you want a list of - untested behaviors plus iteration toward passing tests. -- A user journey needs end-to-end validation in a real browser before - shipping. -- You want test-first iteration on an existing module. - -## When NOT to use - -- You want to assert a single criterion, not build a test suite → use - [03-assert](../03-assert/README.md). -- You're debugging a known failure → use - [08-debug](../08-debug/README.md). -- You want a rule-based code review of existing tests → use - [05-review](../05-review/README.md). - -## How to invoke - -``` -Use skill aidd-dev:06-test -``` - -The skill exposes 2 actions: - -1. `test` - list untested behaviors and iterate on test creation until - tests pass with best practices applied. -2. `test-journey` - navigate a user journey in the browser and validate - each step end-to-end. - -## Outputs - -- New or updated test files following project test conventions. -- A list of remaining untested behaviors when coverage is incomplete. -- A journey transcript with per-step verdicts for the browser variant. - -## Prerequisites - -- A test runner configured in the repo (Jest, Vitest, Playwright, etc.). -- A running app / preview when validating user journeys. -- Browser automation tooling available in the runtime for the journey - variant. - -## Technical details - -See [`SKILL.md`](SKILL.md) and [`actions/`](actions/) for the two test -contracts. The journey action depends on browser tooling exposed by the -runtime. diff --git a/plugins/aidd-dev/skills/07-refactor/README.md b/plugins/aidd-dev/skills/07-refactor/README.md deleted file mode 100644 index acb06dd9..00000000 --- a/plugins/aidd-dev/skills/07-refactor/README.md +++ /dev/null @@ -1,72 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 07 - refactor - -Improves code without breaking behavior across four axes: cleanup -(clean-code + tech debt), performance, security, and architecture. It is -the act-side counterpart of [04-audit](../04-audit/README.md) - audit -reports, refactor fixes. - -## When to use - -- You want to clean up, optimize, harden, or restructure existing code. -- An [04-audit](../04-audit/README.md) report flagged issues to fix now - - push the report into refactor and it fixes the listed findings. -- A profile, security review, or coupling problem points to a concrete - improvement. - -## When NOT to use - -- You only want a read-only diagnosis → run [04-audit](../04-audit/README.md). -- The task is a functional bug fix → use [08-debug](../08-debug/README.md). -- You want to add new behavior, not improve existing → use - [02-implement](../02-implement/README.md). -- You want to add tests → [06-test](../06-test/README.md). - -## How to invoke - -``` -Use skill aidd-dev:07-refactor -``` - -Run-one or run-all: - -- Name an axis (`optimize`, `harden`, `clean up`, `restructure`) → that axis. -- Unscoped (`refactor this`) → the skill asks "all applicable axes, or a - specific one?", then runs the chosen one or all. - -The four axes (each maps to an audit pillar): - -1. `performance` - N+1, hot paths, batching, memoization. -2. `security` - OWASP, validation, authz, secrets (may change behavior to - close a hole). -3. `cleanup` - clean-code: rename, extract, DRY, dead-code, complexity. -4. `architecture` - extract layers, fix coupling, enforce boundaries. - -## Audit handoff (push, never pull) - -Refactor never loads the audit skill. Each axis runs **standalone** (scans -its lens, then fixes) or **audit-fed** when the caller pushes an -`audit_report` (path under `aidd_docs/tasks/audits/` or pasted findings) - -then it fixes that report's findings for its axis and skips its own scan. -The bridge is the report artifact, not a cross-skill dependency. - -## Outputs - -- Code changes scoped to the axis, with a list of `changes_applied`. -- Behavior-preserving verification (tests / types / side-by-side) for - cleanup, performance, architecture; an explicit behavior-change call-out - for security. - -## Prerequisites - -- Tests in place so the refactor is verifiable (or scheduled via - [06-test](../06-test/README.md)). -- For the architecture axis: the documented architecture (C4 / ADRs) in - `aidd_docs/memory/` to enforce against; large moves may need - [01-plan](../01-plan/README.md) first. - -## Technical details - -See [`SKILL.md`](SKILL.md) for routing + the push-not-pull audit handoff, -and [`actions/`](actions/) for each axis contract. diff --git a/plugins/aidd-dev/skills/08-debug/README.md b/plugins/aidd-dev/skills/08-debug/README.md deleted file mode 100644 index 10775b76..00000000 --- a/plugins/aidd-dev/skills/08-debug/README.md +++ /dev/null @@ -1,58 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 08 - debug - -Reproduces and fixes bugs systematically using a test-driven workflow: -reproduce the failure, reflect on hypotheses, validate with logs, then -apply a targeted fix. Drives the loop from issue to PR. - -## When to use - -- A bug is reported and you want a disciplined reproduce → diagnose → - fix → verify loop. -- A flaky test or intermittent failure needs root-cause analysis backed by - validation logs. -- An issue exists in the tracker and you want to ship the fix as a PR. - -## When NOT to use - -- The work is new feature development → use - [00-sdlc](../00-sdlc/README.md) or - [02-implement](../02-implement/README.md). -- The fix is a refactor with no behavioral defect → use - [07-refactor](../07-refactor/README.md). -- You want broad coverage analysis, not one bug → use - [04-audit](../04-audit/README.md). - -## How to invoke - -``` -Use skill aidd-dev:08-debug -``` - -The skill exposes 3 actions: - -1. `reproduce` - produce a deterministic reproduction (failing test or - command). -2. `debug` - diagnose the root cause and apply the fix. -3. `reflect-issue` - enumerate likely causes, rank them, add validation - logs before committing to a hypothesis. - -## Outputs - -- A failing reproduction (test or script) that turns green after the fix. -- A root-cause note attached to the issue or PR. -- Targeted fix commits scoped to the defect. -- Updated tests covering the regression. - -## Prerequisites - -- An issue or report describing the failure (stack trace, repro steps, - expected vs observed). -- Test infrastructure able to host the reproduction. - -## Technical details - -See [`SKILL.md`](SKILL.md) and [`actions/`](actions/) for the three -debug contracts. The reflect-issue action explicitly mandates logs before -acting, to prevent jumping to the wrong hypothesis. diff --git a/plugins/aidd-dev/skills/09-for-sure/README.md b/plugins/aidd-dev/skills/09-for-sure/README.md deleted file mode 100644 index 9bee2507..00000000 --- a/plugins/aidd-dev/skills/09-for-sure/README.md +++ /dev/null @@ -1,66 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 09 - for-sure - -Autonomous loop that runs until a `success_condition` is verified. Two -phases: interactive pre-flight (human present), then autonomous execution -(human gone). The agent auto-accepts everything, acts as the user, and -never stops until the success condition holds. - -## When to use - -- The user says "for sure", "make sure", "keep trying until", "loop until - done", "don't stop until", or otherwise requests guaranteed completion. -- A long-running task with an explicit, verifiable success condition can - run unattended. -- You need a retry loop that tracks attempts in a durable tracking file. - -## When NOT to use - -- No verifiable success condition exists → define one first, or use a - one-shot skill. -- The task is part of a standard SDLC pipeline → use - [00-sdlc](../00-sdlc/README.md). -- The task is a single bug fix → use [08-debug](../08-debug/README.md). -- The task needs human gates mid-loop - this skill auto-accepts and never - asks once it enters Phase 2. - -## How to invoke - -``` -/for-sure -``` - -The skill exposes 3 actions across two phases: - -1. `init-tracking` (Phase 1, interactive) - pre-flight validation, - create the tracking file, spawn the first autonomous agent. -2. `auto-accept` (Phase 2) - activate auto-accept mode for the - autonomous run. -3. `autonomous-loop` (Phase 2) - orchestrator that spawns one worker per - step, verifies output, retries on failure with a meaningful change, - evaluates the success condition. - -## Outputs - -- A tracking file at `aidd_docs/tasks/.md` (state in the - `status` frontmatter field) from For Sure's own plan template, which - extends the [01-plan](../01-plan/README.md) format with - `success_condition` and `iteration`. -- Per-attempt log entries inside the tracking file. -- The tracking file's `status` set to `implemented` once and only once the - success condition genuinely verifies. - -## Prerequisites - -- An explicit `success_condition` expressed as a command whose exit code - (or output) decides success. -- Acceptance criteria and steps documented in the tracking file. -- Task-specific secrets validated during pre-flight (Phase 1). - -## Technical details - -See [`SKILL.md`](SKILL.md) for the iron rules (single source of truth, -no repeated failures, honesty over escape, auto-accept) and -[`actions/`](actions/) for the per-phase contracts. The tracking file -uses For Sure's own plan template asset (`@assets/plan-template.md`). diff --git a/plugins/aidd-dev/skills/10-todo/README.md b/plugins/aidd-dev/skills/10-todo/README.md deleted file mode 100644 index 734bde80..00000000 --- a/plugins/aidd-dev/skills/10-todo/README.md +++ /dev/null @@ -1,19 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-dev](../../README.md) - -# 10 - todo - -Split one prompt into independent todos, run one executor agent per -todo in parallel (each refines its todo before coding), and report a -minimal table: category, what was launched, output. - -## When to use - -- The user says "todo" or `/todo`. -- A single prompt bundles several independent tasks that can be - implemented in parallel. - -## Actions - -| # | Action | Purpose | -| --- | --------------------------------- | --------------------------------------------- | -| 01 | [todo](actions/01-todo.md) | Categorize, launch parallel agents, report. | diff --git a/plugins/aidd-orchestrator/CATALOG.md b/plugins/aidd-orchestrator/CATALOG.md index 625b679b..3b881985 100644 --- a/plugins/aidd-orchestrator/CATALOG.md +++ b/plugins/aidd-orchestrator/CATALOG.md @@ -24,7 +24,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | Group | File | Description | |-------|------|---| -| `-` | [README.md](skills/00-async-dev/README.md) | - | | `references` | [routing.md](skills/00-async-dev/references/routing.md) | - | | `-` | [SKILL.md](skills/00-async-dev/SKILL.md) | `Drive the async-dev pipeline from one entry point, whether setup, run, or review. Use when the user wants to install async dev, run a ready issue, or address PR review comments, or on a webhook trigger. Not for plain status checks.` | diff --git a/plugins/aidd-orchestrator/README.md b/plugins/aidd-orchestrator/README.md index 3c90de17..15eab9e7 100644 --- a/plugins/aidd-orchestrator/README.md +++ b/plugins/aidd-orchestrator/README.md @@ -16,9 +16,9 @@ Composes capabilities into deterministic, auditable flows. Each skill is one orc | Bracket ID | Skill | Description | |------------|-------|-------------| -| [6.0] | [async-dev](skills/00-async-dev/README.md) | Single router-based skill covering the full pipeline — setup, run, and review — selected by `$ARGUMENTS` keyword, trigger source, repo state, or natural-language intent. | +| [6.0] | [async-dev](skills/00-async-dev/SKILL.md) | Single router-based skill covering the full pipeline — setup, run, and review — selected by `$ARGUMENTS` keyword, trigger source, repo state, or natural-language intent. | -See the [skill README](skills/00-async-dev/README.md) for the sub-flow inventory and invocation contract. +See the [skill's SKILL.md](skills/00-async-dev/SKILL.md) for the sub-flow inventory and invocation contract. ### Roadmap diff --git a/plugins/aidd-orchestrator/skills/00-async-dev/README.md b/plugins/aidd-orchestrator/skills/00-async-dev/README.md deleted file mode 100644 index 32097d12..00000000 --- a/plugins/aidd-orchestrator/skills/00-async-dev/README.md +++ /dev/null @@ -1,54 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-orchestrator](../../README.md) - -# 00 - Async-dev - -Single entry point for the async-dev pipeline. Hybrid router that picks one of three internal sub-flows (`setup`, `run`, `review`) from `$ARGUMENTS` keyword, trigger source, repo state, or natural-language intent, then runs that sub-flow to completion. - -## When to use - -- You want to install / configure async-dev in a repo. -- A GitHub event fires (`to-implement` / `to-review` label, `@claude /implement` or `/review` comment) and the workflow needs to react. -- You want to handle a ready issue or address review comments on an open PR. -- The user types "async dev", "/async-dev", or mixes phases ("set up async dev and run on issue 42"). - -## When NOT to use - -- For plain status checks on the async pipeline (read labels / comments directly). -- For SDLC orchestration unrelated to issue / PR automation (use `aidd-dev:00-sdlc`). -- From inside a sub-flow action, actions never re-enter the router. - -## How to invoke - -```text -Use skill aidd-orchestrator:00-async-dev -``` - -With an explicit sub-flow keyword (preferred from CI): - -```text -Use skill aidd-orchestrator:00-async-dev with action=setup -Use skill aidd-orchestrator:00-async-dev with action=run on issue #42 -Use skill aidd-orchestrator:00-async-dev with action=review on PR #17 -``` - -The router reads `$ARGUMENTS`, then trigger env, then repo state, then natural intent. See [`references/routing.md`](references/routing.md) for the full decision tree. - -## Sub-flows - -| Sub-flow | First action | Cardinality | -| -------- | -------------------------------------------------- | ------------------ | -| Setup | [`actions/setup/01-detect-context.md`](actions/setup/01-detect-context.md) | 11 actions, run once per install | -| Run | [`actions/run/01-poll-ready.md`](actions/run/01-poll-ready.md) | 6 actions, run once per ready issue | -| Review | [`actions/review/01-collect-comments.md`](actions/review/01-collect-comments.md) | 4 actions, looped on the PR until stop | - -## Output -Each sub-flow defines its own outputs: - -- **Setup**: workflow file, config file, scripts, labels, schedule routine id (if applicable). -- **Run**: `run-result.json` artefact consumed by the workflow's post-job. -- **Review**: stop-reason + structured summary comment on the PR. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the hybrid routing contract, sub-flow indexes, and rules. -See [`references/routing.md`](references/routing.md) for the full decision tree. diff --git a/plugins/aidd-pm/CATALOG.md b/plugins/aidd-pm/CATALOG.md index a262047f..f7268dce 100644 --- a/plugins/aidd-pm/CATALOG.md +++ b/plugins/aidd-pm/CATALOG.md @@ -28,7 +28,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | Group | File | Description | |-------|------|---| | `actions` | [01-ticket-info.md](skills/01-ticket-info/actions/01-ticket-info.md) | - | -| `-` | [README.md](skills/01-ticket-info/README.md) | - | | `-` | [SKILL.md](skills/01-ticket-info/SKILL.md) | `Retrieve and display a ticket from the configured ticketing tool. Use when the user wants to see, show, or look up a ticket's details. Not for creating a ticket, or commenting on, transitioning, or reassigning one.` | #### `skills/02-user-stories` @@ -42,7 +41,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [05-prioritize.md](skills/02-user-stories/actions/05-prioritize.md) | - | | `actions` | [06-sync-tracker.md](skills/02-user-stories/actions/06-sync-tracker.md) | - | | `assets` | [user-story-template.md](skills/02-user-stories/assets/user-story-template.md) | - | -| `-` | [README.md](skills/02-user-stories/README.md) | - | | `references` | [rating.md](skills/02-user-stories/references/rating.md) | - | | `-` | [SKILL.md](skills/02-user-stories/SKILL.md) | `Turn a feature or epic into a prioritized, estimated, INVEST-compliant user-story backlog in the tracker. Use when the user wants to create, split, estimate, or prioritize user stories. Not for source code or a PRD.` | @@ -53,7 +51,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-prd.md](skills/03-prd/actions/01-prd.md) | - | | `assets` | [prd-template.md](skills/03-prd/assets/prd-template.md) | - | | `assets` | [task-template.md](skills/03-prd/assets/task-template.md) | `Task tracking system to ensure all tasks are categorized and addressed` | -| `-` | [README.md](skills/03-prd/README.md) | - | | `-` | [SKILL.md](skills/03-prd/SKILL.md) | `Generate a structured Product Requirements Document from a need, idea, or brainstorm, confirmed before save. Use when the user wants to draft or generate a PRD or product requirements. Not for user stories or a technical plan.` | #### `skills/04-spec` @@ -63,6 +60,5 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-build.md](skills/04-spec/actions/01-build.md) | - | | `actions` | [02-refine.md](skills/04-spec/actions/02-refine.md) | - | | `assets` | [spec-template.md](skills/04-spec/assets/spec-template.md) | - | -| `-` | [README.md](skills/04-spec/README.md) | - | | `-` | [SKILL.md](skills/04-spec/SKILL.md) | `Generate or refine a spec, a feature's immutable contract, from a request, a PRD, or review findings. Use to draft or refine a spec. Do NOT use to write code, a full PRD, or change a locked spec.` | diff --git a/plugins/aidd-pm/README.md b/plugins/aidd-pm/README.md index 1edfea84..308914a3 100644 --- a/plugins/aidd-pm/README.md +++ b/plugins/aidd-pm/README.md @@ -14,7 +14,7 @@ Covers ticket information retrieval, user story creation, product requirement do | Bracket ID | Skill | Description | |---|---|---| -| [4.1] | [ticket-info](skills/01-ticket-info/README.md) | Retrieve and display ticket information from the configured ticketing tool. | -| [4.2] | [user-stories](skills/02-user-stories/README.md) | Turn a feature or epic into a prioritized, estimated, INVEST-compliant user-story backlog. | -| [4.3] | [prd](skills/03-prd/README.md) | Generate a structured Product Requirements Document. | -| [4.4] | [spec](skills/04-spec/README.md) | Generate and refine a project spec from a free-form human request. The spec is the immutable target a planner consumes. | +| [4.1] | [ticket-info](skills/01-ticket-info/SKILL.md) | Retrieve and display ticket information from the configured ticketing tool. | +| [4.2] | [user-stories](skills/02-user-stories/SKILL.md) | Turn a feature or epic into a prioritized, estimated, INVEST-compliant user-story backlog. | +| [4.3] | [prd](skills/03-prd/SKILL.md) | Generate a structured Product Requirements Document. | +| [4.4] | [spec](skills/04-spec/SKILL.md) | Generate and refine a project spec from a free-form human request. The spec is the immutable target a planner consumes. | diff --git a/plugins/aidd-pm/skills/01-ticket-info/README.md b/plugins/aidd-pm/skills/01-ticket-info/README.md deleted file mode 100644 index fece34b3..00000000 --- a/plugins/aidd-pm/skills/01-ticket-info/README.md +++ /dev/null @@ -1,52 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-pm](../../README.md) - -# 01 - Ticket Info - -Reads ticket details from the configured ticketing tool and displays them in -the chat. Read-only and tool-agnostic: the same skill works whether the -project is on Jira, Linear, GitHub Issues, or any other tracker recorded in -the project memory. - -## When to use - -- "ticket info", "show ticket", "get ticket", "ticket details". -- "what's " when `` looks like a ticket reference. -- Invoking `/ticket-info`. -- Pulling a ticket id from the current branch name when no id is supplied. - -## When NOT to use - -- To create a new issue, use a skill that advertises issue creation in its description (run `/plugin` and browse the **Discover** tab to find one). -- To comment on, transition, or reassign a ticket - this skill is read-only. -- For free-form ticket searches across a project; this skill targets one id. - -## How to invoke - -``` -Use skill aidd-pm:01-ticket-info on -``` - -Or, with no id, let the skill auto-detect from the current git branch: - -``` -Use skill aidd-pm:01-ticket-info -``` - -## Outputs - -- A chat-rendered summary of the ticket: id, title, status, assignee, type, - priority, and description, formatted per the configured tool's conventions. -- No files written. No tracker mutations. - -## Prerequisites - -- Project memory declares the active ticketing tool (or repo config / - environment makes it inferable). -- Auth for that tool is reachable from the runtime (MCP server, CLI, or API - token already configured at the project level). - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract and -[`actions/01-ticket-info.md`](actions/01-ticket-info.md) for the single -atomic action that resolves the id, queries the tool, and formats output. diff --git a/plugins/aidd-pm/skills/02-user-stories/README.md b/plugins/aidd-pm/skills/02-user-stories/README.md deleted file mode 100644 index 95763b00..00000000 --- a/plugins/aidd-pm/skills/02-user-stories/README.md +++ /dev/null @@ -1,58 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-pm](../../README.md) - -# 02 - User Stories - -Turns a feature or epic into a prioritized backlog of INVEST-compliant user -stories. Each story carries acceptance criteria, a pragmatic functional -Definition of Done, an effort estimate, and an impact rating, then is saved to -the project's configured tracker once you validate the draft. - -## When to use - -- "user stories", "create user stories", "write user stories for X". -- "INVEST stories", "draft stories". -- "split this epic", "break down this feature". -- "estimate stories", "prioritize the backlog". -- Invoking `/user-stories`. -- Right after a brainstorming session, when scope is clear enough to slice. - -## When NOT to use - -- To write source code - this skill produces stories, not implementation. -- To draft a full PRD → use `03-prd`. -- To refine a single existing story (edit the tracker directly). -- To copy already-ready story text into a tracker (just paste it). - -## How to invoke - -``` -Use skill aidd-pm:02-user-stories for -``` - -The skill clarifies in at most 3 questions per round, splits an epic into -candidate stories, drafts them, estimates effort and impact, ranks the -backlog, shows it for explicit validation, then saves on confirmation. - -## Outputs - -- A set of INVEST-compliant user stories, each with acceptance criteria, a - functional Definition of Done, dependencies, and story points. -- An impact rating (minor, major, critic) per story. -- The backlog ranked by value against effort and impact. -- One ticket per story created in the configured tracker after explicit - validation. - -## Prerequisites - -- Project memory declares the active ticketing tool with write access. -- A clear-enough feature description; if too vague, the skill asks you to - brainstorm first rather than fabricating stories. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, the files under -[`actions/`](actions) for each step of the chain, -[`references/rating.md`](references/rating.md) for the INVEST, readiness, -Definition of Done, impact, and prioritization definitions, and -[`assets/user-story-template.md`](assets/user-story-template.md) for the story -body template. diff --git a/plugins/aidd-pm/skills/03-prd/README.md b/plugins/aidd-pm/skills/03-prd/README.md deleted file mode 100644 index 9e1a59a3..00000000 --- a/plugins/aidd-pm/skills/03-prd/README.md +++ /dev/null @@ -1,52 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-pm](../../README.md) - -# 03 - PRD - -Drafts a structured Product Requirements Document covering scope, goals, -and acceptance criteria from a feature description or a set of user stories. -Stays at the "what and why" level; never crosses into implementation detail. - -## When to use - -- "prd", "draft prd", "write prd". -- "product requirements for X", "generate a prd". -- Invoking `/prd`. -- After user stories are ready and you need a single document to align - stakeholders before planning starts. - -## When NOT to use - -- To write user stories → use `02-user-stories`. -- To draft a technical implementation plan (libraries, file layout, - algorithms) - those belong to the planning skill in your dev capability. -- To write source code. - -## How to invoke - -``` -Use skill aidd-pm:03-prd for -``` - -The skill parses the input, drafts each section per template, shows the -draft, and waits for explicit validation before saving. - -## Outputs - -- A PRD file saved at - `aidd_docs/tasks//--prd.md`. -- Sections: scope, goals, non-goals, user stories or personas, acceptance - criteria, and any task references needed. -- No tracker mutations. - -## Prerequisites - -- A feature description, a set of user stories, or both. -- Write access to `aidd_docs/tasks/` in the current repo. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, -[`actions/01-prd.md`](actions/01-prd.md) for the single atomic action, -[`assets/prd-template.md`](assets/prd-template.md) for the PRD structure, -and [`assets/task-template.md`](assets/task-template.md) for the lightweight -task template referenced from the PRD when needed. diff --git a/plugins/aidd-pm/skills/04-spec/README.md b/plugins/aidd-pm/skills/04-spec/README.md deleted file mode 100644 index 8a593136..00000000 --- a/plugins/aidd-pm/skills/04-spec/README.md +++ /dev/null @@ -1,60 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-pm](../../README.md) - -# 04 - Spec - -Generate or refine the immutable contract for a feature: its target, hard -constraints, non-goals, and done-when. The spec stays free of implementation -detail and is locked once validated. - -## When to use - -- "draft spec", "spec for X", "generate spec from prd". -- "refine the spec" when review findings come back. -- Invoking `/spec`. - -## When NOT to use - -- To write source code. -- To draft a full PRD → use `03-prd`. -- To modify a spec that has already been validated and locked - the spec - is immutable past that point; open a new spec instead. - -## How to invoke - -Build a fresh spec from a request or an existing PRD: - -``` -Use skill aidd-pm:04-spec build for -``` - -Refine an existing spec from review findings: - -``` -Use skill aidd-pm:04-spec refine on with -``` - -The router picks the action from the inputs: presence of `existing_spec` -and `findings` triggers `refine`; otherwise `build` runs. - -## Outputs - -- A spec file structured per [`assets/spec-template.md`](assets/spec-template.md), - with explicit non-goals, bulleted acceptance criteria, and `TBD: ` markers wherever information is missing. -- On `refine`: the same file rewritten to address the supplied findings. -- The skill never self-validates. A spec is checked against - [`assets/spec-validator.yml`](assets/spec-validator.yml); the findings come - back through `refine` for the next iteration. - -## Prerequisites - -- A free-form request, an existing PRD path, or an existing spec plus a - set of review findings. -- Write access to the spec target path in the current repo. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, -[`actions/01-build.md`](actions/01-build.md) and -[`actions/02-refine.md`](actions/02-refine.md) for the two actions, -and [`assets/`](assets/) for the spec template plus the validator checklist. diff --git a/plugins/aidd-refine/CATALOG.md b/plugins/aidd-refine/CATALOG.md index bd5c4135..4042c979 100644 --- a/plugins/aidd-refine/CATALOG.md +++ b/plugins/aidd-refine/CATALOG.md @@ -41,7 +41,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [03-integrate.md](skills/01-brainstorm/actions/03-integrate.md) | - | | `actions` | [04-finalize.md](skills/01-brainstorm/actions/04-finalize.md) | - | | `assets` | [question-angles.md](skills/01-brainstorm/assets/question-angles.md) | - | -| `-` | [README.md](skills/01-brainstorm/README.md) | - | | `references` | [probing.md](skills/01-brainstorm/references/probing.md) | - | | `-` | [SKILL.md](skills/01-brainstorm/SKILL.md) | `Clarify a vague idea through deep questioning until it is precise enough to act on. Use when the user surfaces a half-formed idea or under-specified request, or asks to brainstorm or refine. Not for scanning an artifact for gaps or writing code.` | @@ -51,7 +50,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai |-------|------|---| | `actions` | [01-challenge.md](skills/02-challenge/actions/01-challenge.md) | - | | `assets` | [report-template.md](skills/02-challenge/assets/report-template.md) | - | -| `-` | [README.md](skills/02-challenge/README.md) | - | | `references` | [confidence-rubric.md](skills/02-challenge/references/confidence-rubric.md) | - | | `-` | [SKILL.md](skills/02-challenge/SKILL.md) | `Rethink just-completed work against an agreed plan, classifying findings as deal-breaker, suggestion, or correct, with a confidence score. Use to challenge or critically review recent work. Not for line-by-line style review or writing code.` | @@ -61,7 +59,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai |-------|------|---| | `actions` | [01-condense.md](skills/03-condense/actions/01-condense.md) | - | | `actions` | [02-stats.md](skills/03-condense/actions/02-stats.md) | - | -| `-` | [README.md](skills/03-condense/README.md) | - | | `references` | [intensity-levels.md](skills/03-condense/references/intensity-levels.md) | - | | `-` | [SKILL.md](skills/03-condense/SKILL.md) | `Toggle terse output mode (lite, full, ultra) that drops filler while code and errors stay verbatim, and report token savings. Use to condense output, switch intensity, or check savings. Not for editing prose or compressing code.` | @@ -73,7 +70,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-render-report.md](skills/04-shadow-areas/actions/02-render-report.md) | - | | `actions` | [03-diff.md](skills/04-shadow-areas/actions/03-diff.md) | - | | `assets` | [report-template.md](skills/04-shadow-areas/assets/report-template.md) | - | -| `-` | [README.md](skills/04-shadow-areas/README.md) | - | | `references` | [categories.md](skills/04-shadow-areas/references/categories.md) | - | | `references` | [locked-sets.json](skills/04-shadow-areas/references/locked-sets.json) | - | | `references` | [probe-style.md](skills/04-shadow-areas/references/probe-style.md) | - | @@ -88,7 +84,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-verify.md](skills/05-fact-check/actions/02-verify.md) | - | | `actions` | [03-report.md](skills/05-fact-check/actions/03-report.md) | - | | `assets` | [report-template.md](skills/05-fact-check/assets/report-template.md) | - | -| `-` | [README.md](skills/05-fact-check/README.md) | - | | `references` | [claim-categories.md](skills/05-fact-check/references/claim-categories.md) | - | | `references` | [report-output-discipline.md](skills/05-fact-check/references/report-output-discipline.md) | - | | `references` | [verification-cascade.md](skills/05-fact-check/references/verification-cascade.md) | - | diff --git a/plugins/aidd-refine/README.md b/plugins/aidd-refine/README.md index 65fd8ef2..2783aad4 100644 --- a/plugins/aidd-refine/README.md +++ b/plugins/aidd-refine/README.md @@ -14,8 +14,8 @@ Five skills that refine inputs and outputs through reflection: clarify vague req | Bracket ID | Skill | Description | | ---------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [5.1] | [brainstorm](skills/01-brainstorm/README.md) | Clarify a vague request through a bounded loop of targeted questions over six clarity dimensions, converging until the request is precise or the user is satisfied. | -| [5.2] | [challenge](skills/02-challenge/README.md) | Rethink prior work to verify correctness against an agreed plan, classifying findings with a confidence score. | -| [5.3] | [condense](skills/03-condense/README.md) | Toggle terse output mode with intensity levels so prose drops fluff while code, errors, and warnings stay verbatim. | -| [5.4] | [shadow-areas](skills/04-shadow-areas/README.md) | Analytical scan of a written artifact for blind spots: each gap is classified by category and severity, paired with a direct-question probe. | -| [5.5] | [fact-check](skills/05-fact-check/README.md) | Verify factual claims against authoritative sources and rewrite the text with footnote citations, hedging anything that cannot be confirmed. | +| [5.1] | [brainstorm](skills/01-brainstorm/SKILL.md) | Clarify a vague request through a bounded loop of targeted questions over six clarity dimensions, converging until the request is precise or the user is satisfied. | +| [5.2] | [challenge](skills/02-challenge/SKILL.md) | Rethink prior work to verify correctness against an agreed plan, classifying findings with a confidence score. | +| [5.3] | [condense](skills/03-condense/SKILL.md) | Toggle terse output mode with intensity levels so prose drops fluff while code, errors, and warnings stay verbatim. | +| [5.4] | [shadow-areas](skills/04-shadow-areas/SKILL.md) | Analytical scan of a written artifact for blind spots: each gap is classified by category and severity, paired with a direct-question probe. | +| [5.5] | [fact-check](skills/05-fact-check/SKILL.md) | Verify factual claims against authoritative sources and rewrite the text with footnote citations, hedging anything that cannot be confirmed. | diff --git a/plugins/aidd-refine/skills/01-brainstorm/README.md b/plugins/aidd-refine/skills/01-brainstorm/README.md deleted file mode 100644 index 4ab29000..00000000 --- a/plugins/aidd-refine/skills/01-brainstorm/README.md +++ /dev/null @@ -1,32 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-refine](../../README.md) - -# 01 - Brainstorm - -Turns a vague idea into a precise one through a deep, natural conversation, at whatever level the user is thinking, functional or technical. It asks pointed questions, follows the threads each answer opens, and challenges assumptions until the idea is clear enough to act on. It digs, it does not tick boxes. - -## When to use - -- The user surfaces a half-formed idea, a fuzzy feature, a technical question, or an under-specified request. -- An idea would otherwise force the next step (plan, code, test) to rest on assumptions. -- The user asks to brainstorm, clarify, or refine before committing. - -## When not to use - -- To scan a written artifact for gaps. Use `aidd-refine:04-shadow-areas`. -- To critique finished work. Use `aidd-refine:02-challenge`. -- The idea is already concrete enough to plan or code. - -## The loop - -`capture` restates the idea and reads its altitude. Then `probe → integrate` repeats: each round asks pointed questions on the live thread, follows the forks the answers open, challenges assumptions, and folds the answers back in. It keeps going until no real ambiguity remains or the user is satisfied. There is no fixed round count, the idea is done when it is clear, not on a timer. `finalize` consolidates the refined idea, flags every open assumption and risk, and offers to persist it as `brainstorm.md` in the feature folder under `aidd_docs/tasks/`, a ticket, or the session only. - -## What makes it dig - -- **Follows threads, not topics.** It pulls on the fork an answer opens (filename versus full-text search, for instance), where the depth is, instead of cycling a fixed list. -- **Works at your altitude.** A technical question gets technical probing, a fuzzy feature gets product probing, never one level finer than you opened. -- **Leans when the facts point.** When the answers favor one option it says so with the tradeoff, and keeps the implementation as a flagged assumption for planning. -- **Flags, never fakes.** Whatever stays open is reported as an assumption or risk, never dressed up as settled. - -## Details - -See [`SKILL.md`](SKILL.md) for the contract, [`actions/`](actions/) for the four actions, [`references/probing.md`](references/probing.md) for how to read altitude, follow threads, the tactics, and when to stop, and [`assets/question-angles.md`](assets/question-angles.md) for the topical prompt banks. diff --git a/plugins/aidd-refine/skills/02-challenge/README.md b/plugins/aidd-refine/skills/02-challenge/README.md deleted file mode 100644 index c415880b..00000000 --- a/plugins/aidd-refine/skills/02-challenge/README.md +++ /dev/null @@ -1,57 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-refine](../../README.md) - -# 02 - Challenge - -Rethinks just-completed work against an agreed plan, surfaces what is wrong, -missing, or duplicated, and classifies each finding as deal-breaker, -suggestion, or correct. Outputs a confidence score so the user knows whether -to ship, iterate, or rework. - -## When to use - -- The user says "challenge this", "rethink your plan", "is this correct", - "review my last decision", "challenge my decision", "challenge what you - did", "is my decision right", "criticize this", or "find flaws". -- A critical review of just-completed work is requested before shipping. -- A decision needs adversarial scrutiny before being committed to. - -## When NOT to use - -- Line-by-line code review against a style guide. -- Implementing features, writing tests, or generating new code. -- Reviewing a plan that has not yet been written. - -## How to invoke - -``` -Use skill aidd-refine:02-challenge -``` - -The skill is single-action - the router dispatches to `challenge` whenever -the trigger phrases above appear. - -1. `challenge` - rethink prior work, classify findings, score confidence - against the agreed plan. - -## Outputs - -- A structured verdict report with three classified buckets: - - **Deal-breakers** - issues that block shipping. - - **Suggestions** - improvements that are not blockers. - - **Correct** - explicit acknowledgement of what is already right. -- A confidence percentage based on the tiered rubric. -- No code edits. The report is informational; the user decides what to act on. - -## Prerequisites - -- A piece of recently completed work (plan, decision, implementation, diff) - to challenge. -- An agreed reference point (plan, spec, decision record) to challenge it - against. Without one, the skill challenges against stated user intent. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, [`actions/`](actions/) for -the single step, and -[`references/confidence-rubric.md`](references/confidence-rubric.md) for the -tiered rubric backing the confidence percentage. diff --git a/plugins/aidd-refine/skills/03-condense/README.md b/plugins/aidd-refine/skills/03-condense/README.md deleted file mode 100644 index af75df33..00000000 --- a/plugins/aidd-refine/skills/03-condense/README.md +++ /dev/null @@ -1,64 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-refine](../../README.md) - -# 03 - Condense - -Toggles a terse output mode with three intensity levels (`lite`, `full`, -`ultra`). Strips articles, filler, and pleasantries from prose while leaving -code blocks, quoted errors, and security warnings verbatim. Also reports real -token usage and estimated savings for the current session. - -## When to use - -- The user says "condense", "condense output", "be more concise", "shorter - answers", "tighten output", "/condense", "/condense full", "/condense - ultra", "stop condense", or "normal mode". -- The user asks for token-savings stats: "/condense-stats", "how much have we - saved", "token savings". -- A long session would benefit from compressed prose without losing technical - substance. - -## When NOT to use - -- Editing existing prose written by the user - only the assistant's own - output style is affected. -- Summarizing a long document into a shorter version. -- Compressing source code, commit messages, or pull request bodies - those - stay in normal English regardless of intensity. - -## How to invoke - -``` -Use skill aidd-refine:03-condense -``` - -The router dispatches by intent: - -- Toggle phrase or intensity command (`condense`, `/condense full`, `stop - condense`, `normal mode`, ...) → `01-condense`. -- Stats query (`/condense-stats`, `how much have we saved`, `token - savings`, ...) → `02-stats`. - -## Outputs - -- A toggled response mode for the rest of the session. No files are written. -- Intensity persists across turns until the user explicitly turns it off - (`stop condense`, `normal mode`, `/condense off`) or toggles the skill - again. -- Stats action returns a formatted report of real token usage and estimated - savings under condense mode for the session. - -## Prerequisites - -- None for the toggle. The skill operates on the assistant's output style. -- Stats action expects a session transcript readable by the - `condense-stats.js` hook. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract, [`actions/`](actions/) for -both steps, and -[`references/intensity-levels.md`](references/intensity-levels.md) for -per-level rules and side-by-side examples. The stats action is backed by the -`condense-stats.js` UserPromptSubmit hook, which intercepts stats triggers, -reads the session transcript, and returns the formatted savings report -without invoking the model. diff --git a/plugins/aidd-refine/skills/04-shadow-areas/README.md b/plugins/aidd-refine/skills/04-shadow-areas/README.md deleted file mode 100644 index efb26a5d..00000000 --- a/plugins/aidd-refine/skills/04-shadow-areas/README.md +++ /dev/null @@ -1,69 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-refine](../../README.md) - -# 04 - Shadow Areas - -Analytically scans a written artifact (idea, user stories, PRD, or spec) for -blind spots: unstated assumptions, missing actors, missing failure modes, -ambiguous terms, missing acceptance criteria, missing edge cases, and missing -dependencies. Each gap is classified by category and severity, paired with a -direct-question probe the author can act on, and written to a structured -`-shadow-report.md` next to the source. - -## When to use - -- The user asks to "find blind spots", "scan for gaps", "shadow report", or - "what's missing" in a written artifact. -- A PRD, spec, idea note, or user-story set needs an analytical pass before - planning or implementation starts. -- A prior shadow report exists and the user re-runs after editing the source, - wanting to see which gaps are closed, still open, or newly introduced. - -## When NOT to use - -- The artifact does not yet exist and the user needs to clarify a vague intent - through iterative questioning - use the `aidd-refine:01-brainstorm` skill. -- The request is to review code style or check implementation correctness. -- The user needs a general chat about what to do next, not a gap analysis. - -## How to invoke - -``` -Use skill aidd-refine:04-shadow-areas -``` - -Provide either a file path or inline text as the source: - -``` -Use skill aidd-refine:04-shadow-areas with -``` - -The router dispatches based on whether a prior report is already present: - -1. `detect` - parse the source, extract gaps, assign category and severity, - write a direct-question probe per gap. -2. `diff` (only when a prior report exists) - load the prior report and - classify each gap as closed, still open, or newly introduced. -3. `render-report` - write `-shadow-report.md` grouped by category - and sorted by severity (blockers first). - -## Outputs - -- A markdown report `-shadow-report.md` written next to the source. -- Each gap entry: `category`, `severity`, `probe`, optional quoted `snippet`. -- Report header carries `status: clean` when zero blockers and zero majors remain. -- On re-runs: three labeled sections (Closed, Still Open, Newly Introduced). - -## Prerequisites - -- A written artifact in markdown (or plain text) the skill can read. -- The file must be inside the working directory; outside-tree relative paths - are rejected. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract and transversal rules. -Action implementations are under [`actions/`](actions/). -The locked taxonomy and severity rubric live in [`references/`](references/); -[`references/locked-sets.json`](references/locked-sets.json) is the single -source of truth reused by both docs and the validator. -The report skeleton is at [`assets/report-template.md`](assets/report-template.md). diff --git a/plugins/aidd-refine/skills/05-fact-check/README.md b/plugins/aidd-refine/skills/05-fact-check/README.md deleted file mode 100644 index 170d6a03..00000000 --- a/plugins/aidd-refine/skills/05-fact-check/README.md +++ /dev/null @@ -1,69 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-refine](../../README.md) - -# 05 - Fact-check - -Verifies the factual claims inside a target text and rewrites it grounded in -evidence. Each verifiable claim is extracted, classified, and checked against a -cheapest-first cascade (project memory and docs, then codebase inspection, then -web lookup). The rewritten answer carries a footnote citation on every confirmed -claim, an explicit hedge on every unconfirmed claim, and both sources whenever -they disagree. - -## When to use - -- The user asks to "fact-check this", "verify that claim", "are you sure", "is - that actually true", "cite your sources", or "where did you get that fact". -- A prior answer states versions, API behavior, dates, or repository facts that - must be confirmed before being trusted. -- The user wants a clear separation between what is sourced and what is a guess. - -## When NOT to use - -- To auto-guard the AI's own output - this skill only fires on an explicit - request. A permanent "always verify" guard belongs in an always-loaded rule. -- To judge code logic correctness or review code style. -- To clarify vague requirements through iterative Q&A - use the - `aidd-refine:01-brainstorm` skill. - -## How to invoke - -``` -Use skill aidd-refine:05-fact-check -``` - -Provide the text to check - the prior answer, a quoted passage, or a pasted -block: - -``` -Use skill aidd-refine:05-fact-check on -``` - -The skill runs a fixed three-step pipeline: - -1. `identify-claims` - extract verifiable claims, classify each, drop opinion. -2. `verify` - run the cascade per claim, assign a verdict and record sources. -3. `report` - rewrite the text with footnote citations, hedge unverified - claims, and surface conflicts with both sources. - -## Outputs - -- The rewritten answer with a `[n]` marker on every verified claim. -- A `## Sources` footnote block - one numbered entry per source. -- A `## Unverified claims` section listing every claim the cascade could not - resolve (omitted when none). -- An optional cache suggestion for stable verified facts, opt-in only. - -## Prerequisites - -- A piece of text whose claims need checking. -- Project memory, docs, and codebase available for the cheap cascade tiers; a - web lookup tool for the last-resort tier. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract and transversal rules. -Action implementations are under [`actions/`](actions/). -The claim taxonomy and the verification cascade live in -[`references/`](references/). -The rewritten-answer skeleton is at -[`assets/report-template.md`](assets/report-template.md). diff --git a/plugins/aidd-ui/CATALOG.md b/plugins/aidd-ui/CATALOG.md index 633d25f1..73912f57 100644 --- a/plugins/aidd-ui/CATALOG.md +++ b/plugins/aidd-ui/CATALOG.md @@ -25,6 +25,5 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | Group | File | Description | |-------|------|---| | `actions` | [01-greet.md](skills/01-hello/actions/01-greet.md) | - | -| `-` | [README.md](skills/01-hello/README.md) | - | | `-` | [SKILL.md](skills/01-hello/SKILL.md) | `Smoke-test that confirms the aidd-ui plugin loads. Use when the user wants to verify the alpha aidd-ui plugin is installed and reachable. Not for real UI or UX design work.` | diff --git a/plugins/aidd-ui/README.md b/plugins/aidd-ui/README.md index f54d34cd..868d24cb 100644 --- a/plugins/aidd-ui/README.md +++ b/plugins/aidd-ui/README.md @@ -25,4 +25,4 @@ One starter skill today; real UI and UX skills land as the concern stabilises. | Bracket ID | Skill | Description | | ---------- | ----- | ----------- | -| [7.1] | [hello](skills/01-hello/README.md) | Smoke-test skill that confirms the plugin loads. | +| [7.1] | [hello](skills/01-hello/SKILL.md) | Smoke-test skill that confirms the plugin loads. | diff --git a/plugins/aidd-ui/skills/01-hello/README.md b/plugins/aidd-ui/skills/01-hello/README.md deleted file mode 100644 index 11b4803c..00000000 --- a/plugins/aidd-ui/skills/01-hello/README.md +++ /dev/null @@ -1,29 +0,0 @@ -← [aidd-ui](../../README.md) - -# hello - -Smoke-test skill for the alpha `aidd-ui` plugin. It greets the caller and confirms the plugin loaded. - -## When to use - -- To verify the alpha `aidd-ui` plugin is installed and reachable after a local install or reload. - -## When NOT to use - -- For real UI or UX design, review, or improvement work. Those skills do not exist yet. - -## How to invoke - -`aidd-ui:01-hello` - -## Outputs - -- A short greeting printed in the chat. - -## Prerequisites - -- The plugin loaded locally (`claude --plugin-dir plugins/aidd-ui`, or installed from the marketplace). - -## Technical details - -See [SKILL.md](SKILL.md). diff --git a/plugins/aidd-ui/skills/01-hello/SKILL.md b/plugins/aidd-ui/skills/01-hello/SKILL.md index 471d5b0c..e3406a95 100644 --- a/plugins/aidd-ui/skills/01-hello/SKILL.md +++ b/plugins/aidd-ui/skills/01-hello/SKILL.md @@ -15,3 +15,7 @@ Confirm the aidd-ui plugin loads and is reachable. Single action skill: run `greet` and return its message. Before running an action, read its file in `actions/`, not only the table or assets. + +## Prerequisites + +- The plugin loaded locally (`claude --plugin-dir plugins/aidd-ui`, or installed from the marketplace). diff --git a/plugins/aidd-vcs/CATALOG.md b/plugins/aidd-vcs/CATALOG.md index 3a2333a6..fed85e29 100644 --- a/plugins/aidd-vcs/CATALOG.md +++ b/plugins/aidd-vcs/CATALOG.md @@ -31,7 +31,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-init.md](skills/00-repo-init/actions/01-init.md) | - | | `actions` | [02-publish.md](skills/00-repo-init/actions/02-publish.md) | - | | `assets` | [CONTRIBUTING.md](skills/00-repo-init/assets/CONTRIBUTING.md) | - | -| `-` | [README.md](skills/00-repo-init/README.md) | - | | `-` | [SKILL.md](skills/00-repo-init/SKILL.md) | `Initialize a project repository with git init, a default branch, a bootstrap commit, CONTRIBUTING.md, and optionally the remote. Use when the user wants to init or set up a new repo, or publish to a remote. Not for committing, opening a PR, or tagging.` | #### `skills/01-commit` @@ -42,7 +41,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [02-message.md](skills/01-commit/actions/02-message.md) | - | | `actions` | [03-commit.md](skills/01-commit/actions/03-commit.md) | - | | `assets` | [commit-template.md](skills/01-commit/assets/commit-template.md) | `VCS commit message template` | -| `-` | [README.md](skills/01-commit/README.md) | - | | `-` | [SKILL.md](skills/01-commit/SKILL.md) | `Create an atomic git commit with a conventional message, optionally pushing. Use when the user wants to commit changes, optionally pushing the branch. Not for amending, rebasing, opening a pull request, or tagging a release.` | #### `skills/02-pull-request` @@ -54,7 +52,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [03-create.md](skills/02-pull-request/actions/03-create.md) | - | | `assets` | [branch.md](skills/02-pull-request/assets/branch.md) | `VCS branch naming convention template` | | `assets` | [pull_request.md](skills/02-pull-request/assets/pull_request.md) | `VCS pull/merge request template` | -| `-` | [README.md](skills/02-pull-request/README.md) | - | | `-` | [SKILL.md](skills/02-pull-request/SKILL.md) | `Create a draft pull or merge request from the current branch, in whatever VCS tool the project uses. Use when the user wants to open a pull or merge request. Not for committing, pushing, or merging a branch.` | #### `skills/03-release-tag` @@ -63,7 +60,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai |-------|------|---| | `actions` | [01-release-tag.md](skills/03-release-tag/actions/01-release-tag.md) | - | | `assets` | [release-template.md](skills/03-release-tag/assets/release-template.md) | `VCS release notes template` | -| `-` | [README.md](skills/03-release-tag/README.md) | - | | `-` | [SKILL.md](skills/03-release-tag/SKILL.md) | `Cut a semver release with an annotated tag and release notes. Use when the user wants to release, tag a release, bump the version, or cut a version. Not for a plain commit, a pull request, or amending an existing tag.` | #### `skills/04-issue-create` @@ -73,6 +69,5 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai | `actions` | [01-issue-create.md](skills/04-issue-create/actions/01-issue-create.md) | - | | `assets` | [CONTRIBUTING.md](skills/04-issue-create/assets/CONTRIBUTING.md) | `Project contribution guidelines template` | | `assets` | [issue-template.md](skills/04-issue-create/assets/issue-template.md) | `VCS issue/ticket template` | -| `-` | [README.md](skills/04-issue-create/README.md) | - | | `-` | [SKILL.md](skills/04-issue-create/SKILL.md) | `Create an issue in the configured ticketing tool. Use when the user wants to file a bug, open an issue, or report a problem. Not for committing, opening a pull request, or commenting on an existing issue.` | diff --git a/plugins/aidd-vcs/README.md b/plugins/aidd-vcs/README.md index 7f24ea67..fe89ad57 100644 --- a/plugins/aidd-vcs/README.md +++ b/plugins/aidd-vcs/README.md @@ -16,10 +16,10 @@ Covers all external artifact creation: commits, pull/merge requests, release tag | Bracket ID | Skill | Description | |---|---|---| -| [3.1] | [commit](skills/01-commit/README.md) | Create a git commit with proper conventional message format. | -| [3.2] | [pull-request](skills/02-pull-request/README.md) | Create PR (GitHub) or MR (GitLab) with filled template. | -| [3.3] | [release-tag](skills/03-release-tag/README.md) | Create and push a semantic version git tag with release notes. | -| [3.4] | [issue-create](skills/04-issue-create/README.md) | Create issues in the configured ticketing tool. | +| [3.1] | [commit](skills/01-commit/SKILL.md) | Create a git commit with proper conventional message format. | +| [3.2] | [pull-request](skills/02-pull-request/SKILL.md) | Create PR (GitHub) or MR (GitLab) with filled template. | +| [3.3] | [release-tag](skills/03-release-tag/SKILL.md) | Create and push a semantic version git tag with release notes. | +| [3.4] | [issue-create](skills/04-issue-create/SKILL.md) | Create issues in the configured ticketing tool. | ## Assets diff --git a/plugins/aidd-vcs/skills/00-repo-init/README.md b/plugins/aidd-vcs/skills/00-repo-init/README.md deleted file mode 100644 index 6c7ecd3b..00000000 --- a/plugins/aidd-vcs/skills/00-repo-init/README.md +++ /dev/null @@ -1,34 +0,0 @@ -← [aidd-vcs](../../README.md) - -# 00-repo-init - -Initializes a project's repository locally and, on request, on the remote host: `git init`, sets the default branch, resolves the provider, and can create the remote repository and push, returning its URL. - -> Status: experimental. - -## When to use - -- Starting version control on a new project (e.g. right after scaffolding it). -- Creating the remote repository and pushing the initial state. - -## When NOT to use - -- Cloning an existing remote, opening pull requests, or tagging releases. -- Re-initializing a directory that is already a repository (the local step no-ops there). - -## How to invoke - -`aidd-vcs:00-repo-init`, or say "initialize a git repository here" / "create the remote and publish". - -## Outputs - -- `init`: an initialized `.git`, the default branch set, the resolved provider, and `origin` added when a remote URL is given. -- `publish`: the created remote repository and a push, returning its URL. - -## Prerequisites - -- `git` on the PATH. For `publish`, the resolved host's tooling (CLI, MCP, or API) available and authenticated. - -## Technical details - -Two actions: `init` (local) and `publish` (remote, outward-facing, confirms first). See [SKILL.md](SKILL.md). diff --git a/plugins/aidd-vcs/skills/00-repo-init/SKILL.md b/plugins/aidd-vcs/skills/00-repo-init/SKILL.md index afe0bd3c..3ec1c1e1 100644 --- a/plugins/aidd-vcs/skills/00-repo-init/SKILL.md +++ b/plugins/aidd-vcs/skills/00-repo-init/SKILL.md @@ -6,6 +6,8 @@ argument-hint: init | publish # Repo Init +> Status: experimental. + Initializes a project's repository locally and, on request, on the remote host, then returns the remote URL. ## Actions @@ -25,6 +27,10 @@ Before running an action, read its file in `actions/`, not only the table or ass - `publish` is outward-facing. It confirms before creating the remote unless `non_interactive` is set. - The provider is open. Resolve the host and how to reach it (CLI, MCP, or API) from the VCS memory when present, else from the VCS tooling available in the environment. Never restrict to a fixed list or a fixed mechanism. `main` is the default-branch fallback. +## Prerequisites + +- `git` on the PATH. For `publish`, the resolved host's tooling (CLI, MCP, or API) available and authenticated. + ## Assets - `assets/CONTRIBUTING.md`: the project-root `CONTRIBUTING.md` template. diff --git a/plugins/aidd-vcs/skills/01-commit/README.md b/plugins/aidd-vcs/skills/01-commit/README.md deleted file mode 100644 index 5f4a992f..00000000 --- a/plugins/aidd-vcs/skills/01-commit/README.md +++ /dev/null @@ -1,53 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-vcs](../../README.md) - -# 01 - Commit - -Creates an atomic git commit with a conventional, imperative-mood message, -optionally pushing the branch when the caller asks for it. - -## When to use - -- The user says "commit", "git commit", "create a commit", "commit my - changes", or "commit and push". -- The user invokes the `/commit` slash command. -- An agent has finished a contained change and needs it recorded as a single - atomic commit. - -## When NOT to use - -- To amend an existing commit (this skill always creates a new one). -- To force-push or rebase the current branch. -- To open a pull or merge request → use `02-pull-request`. -- To cut a release tag → use `03-release-tag`. - -## How to invoke - -``` -Use skill aidd-vcs:01-commit -``` - -Or via the slash command: - -- `/commit` - stage, commit, stay local (`push: false`). -- `/commit push` - stage, commit, then push the branch (`push: true`). - -The skill chains three actions, collect then message then commit, that run -end to end: stage one concern, write the conventional message, commit, and -optionally push. - -## Outputs - -- One new git commit on the current branch with a conventional message. -- Optionally, a pushed branch on the remote when `push: true`. - -## Prerequisites - -- A git repository with at least one staged or unstaged change. -- A configured git identity (`user.name`, `user.email`). -- A writable remote when `push: true`. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract and -[`assets/commit-template.md`](assets/commit-template.md) for the conventional -commit format reference shipped with the skill. diff --git a/plugins/aidd-vcs/skills/02-pull-request/README.md b/plugins/aidd-vcs/skills/02-pull-request/README.md deleted file mode 100644 index 8482dc0d..00000000 --- a/plugins/aidd-vcs/skills/02-pull-request/README.md +++ /dev/null @@ -1,55 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-vcs](../../README.md) - -# 02 - Pull Request - -Drafts a pull request (GitHub) or merge request (GitLab) from the current -branch using the team's template, validates it with the user, and opens it -as a draft for manual promotion. - -## When to use - -- The user says "open a pr", "open a pull request", "create a pr", "create a - merge request", "open mr", or "draft a pr for this branch". -- The user invokes the `/pull-request` slash command. -- A feature branch is ready for review and needs a request opened against - the detected base branch. - -## When NOT to use - -- To commit changes → use `01-commit`. -- To push the working branch on its own (no request created). -- To tag a release → use `03-release-tag`. -- To merge an existing request, or to amend commits. - -## How to invoke - -``` -Use skill aidd-vcs:02-pull-request -``` - -Or via the slash command: `/pull-request`. - -The skill chains three actions, collect then draft then create: collect -resolves the base and gathers the commits, draft writes and validates the -title and body, create opens the request as a draft. - -## Outputs - -- A new draft pull request on GitHub, or a draft merge request on GitLab, - pointing from the current branch to the detected base branch, with the - filled template as its body. - -## Prerequisites - -- A git repository with a remote on GitHub or GitLab. -- The current branch is pushed (or the skill will defer to the user). -- `gh` (GitHub) or `glab` (GitLab) CLI authenticated, depending on the - detected VCS tool. -- The base branch resolves from project memory or remote inspection; the - skill does not assume `main` / `master`. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract. Templates ship in -[`assets/`](assets/): `pull_request.md` (request body) and `branch.md` (naming -conventions). diff --git a/plugins/aidd-vcs/skills/03-release-tag/README.md b/plugins/aidd-vcs/skills/03-release-tag/README.md deleted file mode 100644 index 7041cc93..00000000 --- a/plugins/aidd-vcs/skills/03-release-tag/README.md +++ /dev/null @@ -1,54 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-vcs](../../README.md) - -# 03 - Release Tag - -Cuts a semver release: computes the next version, drafts notes from recent -commits, validates with the user, bumps version-manager files, creates an -annotated git tag, and pushes it. - -## When to use - -- The user says "release", "tag", "tag this release", "bump version", - "release v1.2.0", or "cut a release". -- The user invokes the `/release-tag` slash command. -- A release-ready commit exists on the release branch and needs a versioned - tag with notes. - -## When NOT to use - -- For plain commits without a tag → use `01-commit`. -- To open a pull or merge request → use `02-pull-request`. -- To push a branch only, with no tag created. -- To amend or move an existing tag (this skill never force-updates tags). - -## How to invoke - -``` -Use skill aidd-vcs:03-release-tag -``` - -Or via the slash command: `/release-tag`. - -The skill runs a single action (`release-tag`) that computes the version, -drafts notes, validates with the user, applies the version bump, creates the -annotated tag, and pushes it. - -## Outputs - -- A version-bump commit touching only version-manager files (e.g. - `package.json`, `pyproject.toml`). -- An annotated git tag (`git tag -a vX.Y.Z`) carrying the release notes. -- The bump commit and the tag pushed to the remote. - -## Prerequisites - -- A git repository with a writable remote. -- A version-manager file the skill can update (e.g. `package.json`, - `pyproject.toml`). -- A clean working tree, or changes the user is willing to bundle into the - bump commit when prompted. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract. The release notes -template ships at [`assets/release-template.md`](assets/release-template.md). diff --git a/plugins/aidd-vcs/skills/04-issue-create/README.md b/plugins/aidd-vcs/skills/04-issue-create/README.md deleted file mode 100644 index 1aee05e6..00000000 --- a/plugins/aidd-vcs/skills/04-issue-create/README.md +++ /dev/null @@ -1,54 +0,0 @@ -← [aidd-framework](../../../../README.md) / [aidd-vcs](../../README.md) - -# 04 - Issue Create - -Files a well-formed issue in the configured ticketing tool after gathering -enough context to be actionable, validated with the user before creation. - -## When to use - -- The user says "new issue", "create an issue", "file a bug", "file an - issue", "report bug", or "open an issue". -- The user invokes the `/issue-create` slash command. -- A bug or feature request surfaces during work and needs a tracked record - in whichever ticketing tool the project uses. - -## When NOT to use - -- To commit changes → use `01-commit`. -- To open a pull or merge request → use `02-pull-request`. -- To cut a release tag → use `03-release-tag`. -- To comment on an existing issue (this skill only creates new ones). - -## How to invoke - -``` -Use skill aidd-vcs:04-issue-create -``` - -Or via the slash command: `/issue-create`. - -The skill runs a single action (`issue-create`) that detects the ticketing -tool, fills the issue template, validates title / body / labels / type / -projects / milestones with the user, then creates the issue. - -## Outputs - -- A new issue in the configured tracker (GitHub Issues, GitLab Issues, Jira, - Linear, or whichever tool project memory points at) with the filled - template body, requested labels, type, projects, and milestones. - -## Prerequisites - -- The project memory identifies the ticketing tool, or the remote URL - reveals it via `git remote get-url origin`. -- The matching CLI is authenticated (`gh`, `glab`, etc.) or the tool's API - credentials are configured. -- The user is available to approve the draft before the issue is filed; - the skill always waits for explicit confirmation. - -## Technical details - -See [`SKILL.md`](SKILL.md) for the action contract. Templates ship in -[`assets/`](assets/): `issue-template.md` (issue body) and `CONTRIBUTING.md` -(project-specific issue rules consulted before drafting). From b0142368460cd5b329738db2d4264a3d3f0a5e84 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 7 Jul 2026 06:33:58 +0200 Subject: [PATCH 4/8] ci(deps): bump github/codeql-action/init from 4.36.2 to 4.36.3 (#398) Bumps [github/codeql-action/init](https://github.com/github/codeql-action) from 4.36.2 to 4.36.3. - [Release notes](https://github.com/github/codeql-action/releases) - [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md) - [Commits](https://github.com/github/codeql-action/compare/8aad20d150bbac5944a9f9d289da16a4b0d87c1e...54f647b7e1bb85c95cddabcd46b0c578ec92bc1a) --- updated-dependencies: - dependency-name: github/codeql-action/init dependency-version: 4.36.3 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/codeql.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index 68b81d32..feeacc8e 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -31,7 +31,7 @@ jobs: uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0 - name: Initialize CodeQL - uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2 + uses: github/codeql-action/init@54f647b7e1bb85c95cddabcd46b0c578ec92bc1a # v4.36.3 with: languages: ${{ matrix.language }} queries: security-and-quality From 3a1d1bf4504de8cf543465405c2103f8e275ecfa Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 7 Jul 2026 06:34:14 +0200 Subject: [PATCH 5/8] chore(deps-dev): bump js-yaml from 5.0.0 to 5.2.1 (#401) Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 5.0.0 to 5.2.1. - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/5.0.0...5.2.1) --- updated-dependencies: - dependency-name: js-yaml dependency-version: 5.2.1 dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package.json | 2 +- pnpm-lock.yaml | 19 ++++++++++--------- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/package.json b/package.json index 3a00677e..60c79744 100644 --- a/package.json +++ b/package.json @@ -35,7 +35,7 @@ "@commitlint/config-conventional": "^21.0.2", "ajv": "8.20.0", "ajv-formats": "3.0.1", - "js-yaml": "5.0.0", + "js-yaml": "5.2.1", "lefthook": "^2.1.9" } } diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index d2616131..3089de09 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -21,8 +21,8 @@ importers: specifier: 3.0.1 version: 3.0.1(ajv@8.20.0) js-yaml: - specifier: 5.0.0 - version: 5.0.0 + specifier: 5.2.1 + version: 5.2.1 lefthook: specifier: ^2.1.9 version: 2.1.9 @@ -233,6 +233,7 @@ packages: git-raw-commits@5.0.1: resolution: {integrity: sha512-Y+csSm2GD/PCSh6Isd/WiMjNAydu0VBiG9J7EdQsNA5P9uXvLayqjmTsNlK5Gs9IhblFZqOU0yid5Il5JPoLiQ==} engines: {node: '>=18'} + deprecated: Deprecated and no longer maintained. Use @conventional-changelog/git-client instead. hasBin: true global-directory@5.0.0: @@ -265,12 +266,12 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@4.2.0: - resolution: {integrity: sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==} + js-yaml@4.3.0: + resolution: {integrity: sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==} hasBin: true - js-yaml@5.0.0: - resolution: {integrity: sha512-GSvaPUbk1U+FMZ7rJzF+F8e5YVtu7KnD40et/5rBXXRBv2jCO9L3qCewvIDDdudC0QycTFlf6EAA+h3kxBsuUw==} + js-yaml@5.2.1: + resolution: {integrity: sha512-zfLtNfQqxVqq3uaTqSkh4x4hZw3KHobGUA0fJUj4wawW8bsQLTVqpHdXSIzidh7o+4lEW36tANuAGdaFx6Zgnw==} hasBin: true json-parse-even-better-errors@2.3.1: @@ -596,7 +597,7 @@ snapshots: dependencies: env-paths: 2.2.1 import-fresh: 3.3.1 - js-yaml: 4.2.0 + js-yaml: 4.3.0 parse-json: 5.2.0 optionalDependencies: typescript: 5.9.3 @@ -654,11 +655,11 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@4.2.0: + js-yaml@4.3.0: dependencies: argparse: 2.0.1 - js-yaml@5.0.0: + js-yaml@5.2.1: dependencies: argparse: 2.0.1 From ecede5e426f31696ef0b5777496309958a8b0c0f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 7 Jul 2026 06:35:32 +0200 Subject: [PATCH 6/8] ci(deps): bump github/codeql-action/autobuild from 4.36.2 to 4.36.3 (#399) Bumps [github/codeql-action/autobuild](https://github.com/github/codeql-action) from 4.36.2 to 4.36.3. - [Release notes](https://github.com/github/codeql-action/releases) - [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md) - [Commits](https://github.com/github/codeql-action/compare/8aad20d150bbac5944a9f9d289da16a4b0d87c1e...54f647b7e1bb85c95cddabcd46b0c578ec92bc1a) --- updated-dependencies: - dependency-name: github/codeql-action/autobuild dependency-version: 4.36.3 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/codeql.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index feeacc8e..473462d3 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -37,7 +37,7 @@ jobs: queries: security-and-quality - name: Autobuild - uses: github/codeql-action/autobuild@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2 + uses: github/codeql-action/autobuild@54f647b7e1bb85c95cddabcd46b0c578ec92bc1a # v4.36.3 - name: Perform CodeQL Analysis uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2 From aef39acd829db9613669769f32c4b6b765b1a16c Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 7 Jul 2026 06:35:35 +0200 Subject: [PATCH 7/8] ci(deps): bump github/codeql-action/analyze from 4.36.2 to 4.36.3 (#400) Bumps [github/codeql-action/analyze](https://github.com/github/codeql-action) from 4.36.2 to 4.36.3. - [Release notes](https://github.com/github/codeql-action/releases) - [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md) - [Commits](https://github.com/github/codeql-action/compare/8aad20d150bbac5944a9f9d289da16a4b0d87c1e...54f647b7e1bb85c95cddabcd46b0c578ec92bc1a) --- updated-dependencies: - dependency-name: github/codeql-action/analyze dependency-version: 4.36.3 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/codeql.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index 473462d3..6ce318e1 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -40,6 +40,6 @@ jobs: uses: github/codeql-action/autobuild@54f647b7e1bb85c95cddabcd46b0c578ec92bc1a # v4.36.3 - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2 + uses: github/codeql-action/analyze@54f647b7e1bb85c95cddabcd46b0c578ec92bc1a # v4.36.3 with: category: "/language:${{ matrix.language }}" From 7849f795d7494d58acc38de311c2de2097d1d7b7 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 7 Jul 2026 04:36:23 +0000 Subject: [PATCH 8/8] chore(deps-dev): bump @commitlint/cli from 21.0.2 to 21.2.0 Bumps [@commitlint/cli](https://github.com/conventional-changelog/commitlint/tree/HEAD/@commitlint/cli) from 21.0.2 to 21.2.0. - [Release notes](https://github.com/conventional-changelog/commitlint/releases) - [Changelog](https://github.com/conventional-changelog/commitlint/blob/master/@commitlint/cli/CHANGELOG.md) - [Commits](https://github.com/conventional-changelog/commitlint/commits/v21.2.0/@commitlint/cli) --- updated-dependencies: - dependency-name: "@commitlint/cli" dependency-version: 21.2.0 dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- package.json | 2 +- pnpm-lock.yaml | 235 ++++++++++++++++++++++++++++++------------------- 2 files changed, 146 insertions(+), 91 deletions(-) diff --git a/package.json b/package.json index 60c79744..5e7fdbd0 100644 --- a/package.json +++ b/package.json @@ -31,7 +31,7 @@ "prepare": "lefthook install || true" }, "devDependencies": { - "@commitlint/cli": "^21.0.2", + "@commitlint/cli": "^21.2.0", "@commitlint/config-conventional": "^21.0.2", "ajv": "8.20.0", "ajv-formats": "3.0.1", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 3089de09..4bc5ab2e 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -9,8 +9,8 @@ importers: .: devDependencies: '@commitlint/cli': - specifier: ^21.0.2 - version: 21.0.2(@types/node@25.3.5)(conventional-commits-parser@6.4.0)(typescript@5.9.3) + specifier: ^21.2.0 + version: 21.2.0(@types/node@25.3.5)(conventional-commits-parser@6.4.0)(typescript@5.9.3) '@commitlint/config-conventional': specifier: ^21.0.2 version: 21.0.2 @@ -37,8 +37,8 @@ packages: resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==} engines: {node: '>=6.9.0'} - '@commitlint/cli@21.0.2': - resolution: {integrity: sha512-YMmfLbqBg+ZRvvmPhc+cilSQFrh/AgzVgCT1U/OifmUZEwPbvCtA8rN//YNaF9d5eoZphxVMGYtmwA2QgQORgg==} + '@commitlint/cli@21.2.0': + resolution: {integrity: sha512-4GLVIhUaT3c3GBlQ0GB80/5H3xXdn/Tgw4lrsuoOQVDu2wl4Xw0GuzSar8xZKSMv4H3xaKaQXmvH91GmdyYBZA==} engines: {node: '>=22.12.0'} hasBin: true @@ -46,66 +46,74 @@ packages: resolution: {integrity: sha512-P/ZRhryQmkj0Z0dY9FOoRwe3xkwJyyAdtXwt01NT2kuZttcG2CNYp1q5Ci3u+nDT2jcbJRw2kt13Czl1qKNPfg==} engines: {node: '>=22.12.0'} - '@commitlint/config-validator@21.0.1': - resolution: {integrity: sha512-Zd2UFdndeMMaW2O96HK0tdfT4gOImUvidMpAd/pws2zZ4m1nrAZ/9b/v2JYuE8fs86GpXv9F7LNaIuCIWhY+pA==} + '@commitlint/config-conventional@21.2.0': + resolution: {integrity: sha512-Qf8WRDVcyVd14if6VTWenebxFbKnVnbzPUJjlzjkyJGeHK2xCGd63Dr1XZzj0plXKQb9P0BfOxoc1HVeCo2BWQ==} + engines: {node: '>=22.12.0'} + + '@commitlint/config-validator@21.2.0': + resolution: {integrity: sha512-t7AzNHAKeIdo/3NRGwzpufKHsKkPHmFs/56N2Fnsh0/r0rGtnQzTxk6vnFgjaGr4hdSQKNB50/KAhR9Yk4LJKA==} engines: {node: '>=22.12.0'} - '@commitlint/ensure@21.0.1': - resolution: {integrity: sha512-jJ1037967wU7YN/xkv+iRlOBlmaOXPhPO5KQSqya6GyXzBlwuLzELBFao16DVg9dZyqmNrhewzwZ3SAibetHBQ==} + '@commitlint/ensure@21.2.0': + resolution: {integrity: sha512-76IF9vDNS13lAzEEik9eKwzt8f9hYhWiwVXZ2AnyLCz5/f511FsEQ3pw1X3/zSQpdRLQU7i5qDMVKyXi1GWjSg==} engines: {node: '>=22.12.0'} '@commitlint/execute-rule@21.0.1': resolution: {integrity: sha512-RifH+FmImozKBE6mozhF4K3r2RRKP7SMi/Q/zLCmExtp5e05lhHOUYqGBlFBAGNHaZxU/WYw1XuugYK9jQzqnA==} engines: {node: '>=22.12.0'} - '@commitlint/format@21.0.1': - resolution: {integrity: sha512-ksmG2+cHGtuDPQQbhBbC4unwm444+6TiPw0d1bKf67hntgZqZ8E0g1MuYKUuyT5IH4IMmXZhKq22/Z3jBvtQIw==} + '@commitlint/format@21.2.0': + resolution: {integrity: sha512-c4q64xaav2U83t7k7RyzJerBZurPer7FxUOY0RL5L/6CZijZ7K+s6HIBGIghj0ey1P2+seRX0J9XQYtDued6tg==} engines: {node: '>=22.12.0'} - '@commitlint/is-ignored@21.0.2': - resolution: {integrity: sha512-H5z4t8PC9tUsmZ/o+EptM3Nq8sTFtskAShdcqxCoyzklW5eaVT5xbrDAET2uypzir9Vsj4ZZmBtyKjYe2XqgeQ==} + '@commitlint/is-ignored@21.2.0': + resolution: {integrity: sha512-4/eB0vBN7L88O/oC4ajAEqi7j2ZfNgxl/+11RfAV9YosejZgDXhY2C9VcHnHJhOzPLoSy5P3Mg/46kqeyJfXKw==} engines: {node: '>=22.12.0'} - '@commitlint/lint@21.0.2': - resolution: {integrity: sha512-PnUmLYGeGLfW8oVatR9KpNxSHYAnJOEWlMZzfdeFOUq6WUrFx1fGQaWCWJqMoIll/xPM+GdfJV+tKHZVHhl0Fg==} + '@commitlint/lint@21.2.0': + resolution: {integrity: sha512-ceO5dp9pLjEZ6y6qbq/uXWXDPykqqlTsyzoQ0NzecpisSJhK3kTy9qzQoPeJuWG/IMNdV1lO0RgmzqoAlSi1uw==} engines: {node: '>=22.12.0'} - '@commitlint/load@21.0.2': - resolution: {integrity: sha512-lwUE70hN0/qE/ZRROhbaX65ly/FF12DrqfReLCESo37M0OQCFAf2jRS+2tSCSORq+bm4Kdju7qNDj46uc1QzTA==} + '@commitlint/load@21.2.0': + resolution: {integrity: sha512-RjlzWQqruRwIenJEfZtq7kG97co97nKoHpflE5YnF61tDLXxHPrdWImgzw6VL6MlFyaOcVlk74eBV8ZQmc3oIA==} engines: {node: '>=22.12.0'} - '@commitlint/message@21.0.2': - resolution: {integrity: sha512-5n4aqHGD/FNnom/D5L8i7cYtV+xjuXcBL832C3w9VglEsZzIsoHpJsvxzJ7cgiOsOdc/2jU4t5+7qMHh7GBX3g==} + '@commitlint/message@21.2.0': + resolution: {integrity: sha512-YxGoiXD/HXNXLJPrQwE5poXa+XH0CBEm+mdvbHQP0g6MV/dmJyUFCzPNzZbxL93GvZ70TmtTK0Z0/IBpAqHv8g==} engines: {node: '>=22.12.0'} - '@commitlint/parse@21.0.2': - resolution: {integrity: sha512-QVZJhGHTm+oiuWyEKOCTQ0ZM3mfJ0eGWFeHuj7WzSKEth+UukcCHac9GD8pgdFlg/qGkFWOtyaNd1T8REgagaw==} + '@commitlint/parse@21.2.0': + resolution: {integrity: sha512-QHWxG4d0PLTF634/AdyZ0MQS+CLn5YOuJlCFhMMlSGKFxzYGUetkHBj18xgBD+6fVzUrA2lrCdi/vlS2f/oYXg==} engines: {node: '>=22.12.0'} - '@commitlint/read@21.0.2': - resolution: {integrity: sha512-BtsrnLVycSSKf4Q0gMch4giCj5NNlmcbhc8ra5vONgGtP2IjRDo33bEFtr5Pm+2N+5fXGWb2MksWPrspPfdhdw==} + '@commitlint/read@21.2.0': + resolution: {integrity: sha512-ELx8Ovh/JoAw5lpvDgxc6Y0We9skf2IPI2RFN+gnYgDGjRdMSF8zeodxhZmcclLWzfUIF7hXLOa8gOlllYcvBA==} engines: {node: '>=22.12.0'} - '@commitlint/resolve-extends@21.0.1': - resolution: {integrity: sha512-0DhjYWL6uYrY16Efa032fYk3woGJDU4AGWiG1XXltT9AMUNYKyb5cIZU2ivbaMZ3+kKFqUjikD2cjh66Sbh/Sg==} + '@commitlint/resolve-extends@21.2.0': + resolution: {integrity: sha512-4O/1j51+79Wth9s/MGxt/5gs0XYLDgNlYpltQfhAvLE0itusLKs9zruxbiNg1oOkmkb9L9L4USYGjEj7n87NxA==} engines: {node: '>=22.12.0'} - '@commitlint/rules@21.0.2': - resolution: {integrity: sha512-k6tQ69Td7t2qUSIbik8D3TL1q3ZJpkEbV+yLogDzCRAdOxJm4ndhtBNREsLA1/puRfWvzS9eioF2w43WT+hHgQ==} + '@commitlint/rules@21.2.0': + resolution: {integrity: sha512-C2yXMNpiB8ETZKfx5JD8+ExgF8vTU1VQMKPSUUYwqKpw9oJWQBrlXBpdU038mj2WPjof7o9UzFpmTyBeGMZwZg==} engines: {node: '>=22.12.0'} '@commitlint/to-lines@21.0.1': resolution: {integrity: sha512-bd1BFII7p1EQZre9Kaj+kKaMFP3cFCdt21K7DItVux9XP5WjLgJ0/Uy1pJJh9aPwVJ6SKg62PxqlZaHI8hQAXw==} engines: {node: '>=22.12.0'} - '@commitlint/top-level@21.0.2': - resolution: {integrity: sha512-s9KKM+e+mXgFeIh4n7KmOGAVT3mkJ3Fp1bBYHIK5pjeUwlEMzp/tZfb5u0Poa680AsQTXMEMRxZi1vQ9m2X5ug==} + '@commitlint/top-level@21.2.0': + resolution: {integrity: sha512-Y5gmQ+KxzqCrBFJfLvFEPvvwD3LDiNZoTT2yeFBm96M8qhmqSzQc5DvX3rheAaAMjyIvMXOCLS/mWfdpONsjyQ==} engines: {node: '>=22.12.0'} '@commitlint/types@21.0.1': resolution: {integrity: sha512-4u7w8jcoCUFWhjWnASYzZHAP34OqOtuFBN87nQmFvqda03YU0T6z+yB4w0gSAMpekiRqqGk5rt+qSlW+a2vSEg==} engines: {node: '>=22.12.0'} + '@commitlint/types@21.2.0': + resolution: {integrity: sha512-7zVFCDB2reMvJH5dmbKnOQPjZEvjdJTH8jc0U/PIPU1r3/+vf5pD1HlfitV2MWsWXrvu7u39iY1lyLUPOaN0Gw==} + engines: {node: '>=22.12.0'} + '@conventional-changelog/git-client@2.7.0': resolution: {integrity: sha512-j7A8/LBEQ+3rugMzPXoKYzyUPpw/0CBQCyvtTR7Lmu4olG4yRC/Tfkq79Mr3yuPs0SUitlO2HwGP3gitMJnRFw==} engines: {node: '>=18'} @@ -118,6 +126,10 @@ packages: conventional-commits-parser: optional: true + '@conventional-changelog/template@1.2.1': + resolution: {integrity: sha512-TzlTVpKPjaqW6qOYjQcYUDuGsLCNsvFHVBXkYGTAnf5V37jCWrE5haKNXzz0WZUtVHjrpV76L1buANjwXMfT8w==} + engines: {node: '>=22'} + '@simple-libs/child-process-utils@1.0.2': resolution: {integrity: sha512-/4R8QKnd/8agJynkNdJmNw2MBxuFTRcNFnE5Sg/G+jkSsV8/UBgULMzhizWWW42p8L5H7flImV2ATi79Ove2Tw==} engines: {node: '>=18'} @@ -126,6 +138,10 @@ packages: resolution: {integrity: sha512-KxXvfapcixpz6rVEB6HPjOUZT22yN6v0vI0urQSk1L8MlEWPDFCZkhw2xmkyoTGYeFw7tWTZd7e3lVzRZRN/EA==} engines: {node: '>=18'} + '@simple-libs/stream-utils@2.0.0': + resolution: {integrity: sha512-fCTuZK4QBa+39Oz9l4OGfJfz+GpwCp3AqO7Zch3to99xHPgstVsRFpeQ8LNd2o1Gv8raL2mCFwiaHh7bFSp5DQ==} + engines: {node: '>=22'} + '@types/node@25.3.5': resolution: {integrity: sha512-oX8xrhvpiyRCQkG1MFchB09f+cXftgIXb3a7UUa4Y3wpmZPw5tyZGTLWhlESOLq1Rq6oDlc8npVU2/9xiCuXMA==} @@ -165,9 +181,13 @@ packages: compare-func@2.0.0: resolution: {integrity: sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==} - conventional-changelog-angular@8.3.1: - resolution: {integrity: sha512-6gfI3otXK5Ph5DfCOI1dblr+kN3FAm5a97hYoQkqNZxOaYa5WKfXH+AnpsmS+iUH2mgVC2Cg2Qw9m5OKcmNrIg==} - engines: {node: '>=18'} + conventional-changelog-angular@9.2.1: + resolution: {integrity: sha512-oWSL6ZhnXbYraOFTK3PgRAQJ8fADDAEv5K6AdeyQPLvjFmhG8+ejL0jZZp/R7vTmGJaBvZEE+sE7dB4bCv7sAw==} + engines: {node: '>=22'} + + conventional-changelog-conventionalcommits@10.2.1: + resolution: {integrity: sha512-n4Kr1HFMTf3iMbES0TMxKIcYtUUv4rKqyQQp2JwfOEfFCOfGT3Tq4mCyJ8S9/YPyWhydjfKrrvnyl+gCjA+mJQ==} + engines: {node: '>=22'} conventional-changelog-conventionalcommits@9.3.1: resolution: {integrity: sha512-dTYtpIacRpcZgrvBYvBfArMmK2xvIpv2TaxM0/ZI5CBtNUzvF2x0t15HsbRABWprS6UPmvj+PzHVjSx4qAVKyw==} @@ -178,6 +198,11 @@ packages: engines: {node: '>=18'} hasBin: true + conventional-commits-parser@7.0.1: + resolution: {integrity: sha512-6VtskFpPsNkGVk/TY2RnV/MEdKfvCPBtQZN9x8jh9+k5RWBQ+tiaWn5UFCzTr0Dd88iKx7xghxbjBRp5uIzp3g==} + engines: {node: '>=22'} + hasBin: true + cosmiconfig-typescript-loader@6.3.0: resolution: {integrity: sha512-Akr82WH1Wfqatyiqpj8HDkO2o2KmJRu1FhKfSNJP3K4IdXwHfEyL7MOb62i1AGQVLtIQM+iCE9CGOtrfhR+mmA==} engines: {node: '>=v18'} @@ -186,8 +211,8 @@ packages: cosmiconfig: '>=9' typescript: '>=5' - cosmiconfig@9.0.1: - resolution: {integrity: sha512-hr4ihw+DBqcvrsEDioRO31Z17x71pUYoNe/4h6Z0wB72p7MU7/9gH8Q3s12NFhHPfYBBOV3qyfUxmr/Yn3shnQ==} + cosmiconfig@9.0.2: + resolution: {integrity: sha512-gtTZxTDau1wL7Y7zifc2dd8jHSK/k6BTx/2Xp/BpdlAdnlYWFVt7qhJqgwi7637yRwRQ3qL4ZidbB4I8tA5VOg==} engines: {node: '>=14'} peerDependencies: typescript: '>=4.9.5' @@ -209,8 +234,8 @@ packages: error-ex@1.3.4: resolution: {integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==} - es-toolkit@1.47.0: - resolution: {integrity: sha512-n1GuoD0WEQZMBk5tttoZSqwgyLx01oqa5XsBmCHwPyNe1S9jPBEmtR2pSgp2kJuWE3ciFZ6yRHmY4pM4C3OOkw==} + es-toolkit@1.49.0: + resolution: {integrity: sha512-G5iZ6Pc/FNRY/soKZHC+TxGDD83rHUDXxzaWhGCX44vAv/tMs56WMusnm/KMNK+luUPsgA9U28cGr4RDlSzL2g==} escalade@3.2.0: resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==} @@ -341,6 +366,10 @@ packages: resolution: {integrity: sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==} engines: {node: '>=18'} + meow@14.1.0: + resolution: {integrity: sha512-EDYo6VlmtnumlcBCbh1gLJ//9jvM/ndXHfVXIFrZVr6fGcwTUyCTFNTLCKuY3ffbK8L/+3Mzqnd58RojiZqHVw==} + engines: {node: '>=20'} + parent-module@1.0.1: resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==} engines: {node: '>=6'} @@ -364,8 +393,8 @@ packages: resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==} engines: {node: '>=8'} - semver@7.8.1: - resolution: {integrity: sha512-rkVq3IXh+4FDGch+KwzX3aV9W3kO54GyEgpvBzSyctDA6Xtd7RJQV1xmXbeQp5v7+VzLOfVqiutSE6GICgPFvg==} + semver@7.8.5: + resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==} engines: {node: '>=10'} hasBin: true @@ -415,13 +444,14 @@ snapshots: '@babel/helper-validator-identifier@7.29.7': {} - '@commitlint/cli@21.0.2(@types/node@25.3.5)(conventional-commits-parser@6.4.0)(typescript@5.9.3)': + '@commitlint/cli@21.2.0(@types/node@25.3.5)(conventional-commits-parser@6.4.0)(typescript@5.9.3)': dependencies: - '@commitlint/format': 21.0.1 - '@commitlint/lint': 21.0.2 - '@commitlint/load': 21.0.2(@types/node@25.3.5)(typescript@5.9.3) - '@commitlint/read': 21.0.2(conventional-commits-parser@6.4.0) - '@commitlint/types': 21.0.1 + '@commitlint/config-conventional': 21.2.0 + '@commitlint/format': 21.2.0 + '@commitlint/lint': 21.2.0 + '@commitlint/load': 21.2.0(@types/node@25.3.5)(typescript@5.9.3) + '@commitlint/read': 21.2.0(conventional-commits-parser@6.4.0) + '@commitlint/types': 21.2.0 tinyexec: 1.2.4 yargs: 18.0.0 transitivePeerDependencies: @@ -435,86 +465,91 @@ snapshots: '@commitlint/types': 21.0.1 conventional-changelog-conventionalcommits: 9.3.1 - '@commitlint/config-validator@21.0.1': + '@commitlint/config-conventional@21.2.0': dependencies: - '@commitlint/types': 21.0.1 + '@commitlint/types': 21.2.0 + conventional-changelog-conventionalcommits: 10.2.1 + + '@commitlint/config-validator@21.2.0': + dependencies: + '@commitlint/types': 21.2.0 ajv: 8.20.0 - '@commitlint/ensure@21.0.1': + '@commitlint/ensure@21.2.0': dependencies: - '@commitlint/types': 21.0.1 - es-toolkit: 1.47.0 + '@commitlint/types': 21.2.0 + es-toolkit: 1.49.0 '@commitlint/execute-rule@21.0.1': {} - '@commitlint/format@21.0.1': + '@commitlint/format@21.2.0': dependencies: - '@commitlint/types': 21.0.1 + '@commitlint/types': 21.2.0 picocolors: 1.1.1 - '@commitlint/is-ignored@21.0.2': + '@commitlint/is-ignored@21.2.0': dependencies: - '@commitlint/types': 21.0.1 - semver: 7.8.1 + '@commitlint/types': 21.2.0 + semver: 7.8.5 - '@commitlint/lint@21.0.2': + '@commitlint/lint@21.2.0': dependencies: - '@commitlint/is-ignored': 21.0.2 - '@commitlint/parse': 21.0.2 - '@commitlint/rules': 21.0.2 - '@commitlint/types': 21.0.1 + '@commitlint/is-ignored': 21.2.0 + '@commitlint/parse': 21.2.0 + '@commitlint/rules': 21.2.0 + '@commitlint/types': 21.2.0 - '@commitlint/load@21.0.2(@types/node@25.3.5)(typescript@5.9.3)': + '@commitlint/load@21.2.0(@types/node@25.3.5)(typescript@5.9.3)': dependencies: - '@commitlint/config-validator': 21.0.1 + '@commitlint/config-validator': 21.2.0 '@commitlint/execute-rule': 21.0.1 - '@commitlint/resolve-extends': 21.0.1 - '@commitlint/types': 21.0.1 - cosmiconfig: 9.0.1(typescript@5.9.3) - cosmiconfig-typescript-loader: 6.3.0(@types/node@25.3.5)(cosmiconfig@9.0.1(typescript@5.9.3))(typescript@5.9.3) - es-toolkit: 1.47.0 + '@commitlint/resolve-extends': 21.2.0 + '@commitlint/types': 21.2.0 + cosmiconfig: 9.0.2(typescript@5.9.3) + cosmiconfig-typescript-loader: 6.3.0(@types/node@25.3.5)(cosmiconfig@9.0.2(typescript@5.9.3))(typescript@5.9.3) + es-toolkit: 1.49.0 is-plain-obj: 4.1.0 picocolors: 1.1.1 transitivePeerDependencies: - '@types/node' - typescript - '@commitlint/message@21.0.2': {} + '@commitlint/message@21.2.0': {} - '@commitlint/parse@21.0.2': + '@commitlint/parse@21.2.0': dependencies: - '@commitlint/types': 21.0.1 - conventional-changelog-angular: 8.3.1 - conventional-commits-parser: 6.4.0 + '@commitlint/types': 21.2.0 + conventional-changelog-angular: 9.2.1 + conventional-commits-parser: 7.0.1 - '@commitlint/read@21.0.2(conventional-commits-parser@6.4.0)': + '@commitlint/read@21.2.0(conventional-commits-parser@6.4.0)': dependencies: - '@commitlint/top-level': 21.0.2 - '@commitlint/types': 21.0.1 + '@commitlint/top-level': 21.2.0 + '@commitlint/types': 21.2.0 git-raw-commits: 5.0.1(conventional-commits-parser@6.4.0) tinyexec: 1.2.4 transitivePeerDependencies: - conventional-commits-filter - conventional-commits-parser - '@commitlint/resolve-extends@21.0.1': + '@commitlint/resolve-extends@21.2.0': dependencies: - '@commitlint/config-validator': 21.0.1 - '@commitlint/types': 21.0.1 - es-toolkit: 1.47.0 + '@commitlint/config-validator': 21.2.0 + '@commitlint/types': 21.2.0 + es-toolkit: 1.49.0 global-directory: 5.0.0 resolve-from: 5.0.0 - '@commitlint/rules@21.0.2': + '@commitlint/rules@21.2.0': dependencies: - '@commitlint/ensure': 21.0.1 - '@commitlint/message': 21.0.2 + '@commitlint/ensure': 21.2.0 + '@commitlint/message': 21.2.0 '@commitlint/to-lines': 21.0.1 - '@commitlint/types': 21.0.1 + '@commitlint/types': 21.2.0 '@commitlint/to-lines@21.0.1': {} - '@commitlint/top-level@21.0.2': + '@commitlint/top-level@21.2.0': dependencies: escalade: 3.2.0 @@ -523,20 +558,29 @@ snapshots: conventional-commits-parser: 6.4.0 picocolors: 1.1.1 + '@commitlint/types@21.2.0': + dependencies: + conventional-commits-parser: 7.0.1 + picocolors: 1.1.1 + '@conventional-changelog/git-client@2.7.0(conventional-commits-parser@6.4.0)': dependencies: '@simple-libs/child-process-utils': 1.0.2 '@simple-libs/stream-utils': 1.2.0 - semver: 7.8.1 + semver: 7.8.5 optionalDependencies: conventional-commits-parser: 6.4.0 + '@conventional-changelog/template@1.2.1': {} + '@simple-libs/child-process-utils@1.0.2': dependencies: '@simple-libs/stream-utils': 1.2.0 '@simple-libs/stream-utils@1.2.0': {} + '@simple-libs/stream-utils@2.0.0': {} + '@types/node@25.3.5': dependencies: undici-types: 7.18.2 @@ -573,9 +617,13 @@ snapshots: array-ify: 1.0.0 dot-prop: 5.3.0 - conventional-changelog-angular@8.3.1: + conventional-changelog-angular@9.2.1: dependencies: - compare-func: 2.0.0 + '@conventional-changelog/template': 1.2.1 + + conventional-changelog-conventionalcommits@10.2.1: + dependencies: + '@conventional-changelog/template': 1.2.1 conventional-changelog-conventionalcommits@9.3.1: dependencies: @@ -586,14 +634,19 @@ snapshots: '@simple-libs/stream-utils': 1.2.0 meow: 13.2.0 - cosmiconfig-typescript-loader@6.3.0(@types/node@25.3.5)(cosmiconfig@9.0.1(typescript@5.9.3))(typescript@5.9.3): + conventional-commits-parser@7.0.1: + dependencies: + '@simple-libs/stream-utils': 2.0.0 + meow: 14.1.0 + + cosmiconfig-typescript-loader@6.3.0(@types/node@25.3.5)(cosmiconfig@9.0.2(typescript@5.9.3))(typescript@5.9.3): dependencies: '@types/node': 25.3.5 - cosmiconfig: 9.0.1(typescript@5.9.3) + cosmiconfig: 9.0.2(typescript@5.9.3) jiti: 2.6.1 typescript: 5.9.3 - cosmiconfig@9.0.1(typescript@5.9.3): + cosmiconfig@9.0.2(typescript@5.9.3): dependencies: env-paths: 2.2.1 import-fresh: 3.3.1 @@ -614,7 +667,7 @@ snapshots: dependencies: is-arrayish: 0.2.1 - es-toolkit@1.47.0: {} + es-toolkit@1.49.0: {} escalade@3.2.0: {} @@ -714,6 +767,8 @@ snapshots: meow@13.2.0: {} + meow@14.1.0: {} + parent-module@1.0.1: dependencies: callsites: 3.1.0 @@ -733,7 +788,7 @@ snapshots: resolve-from@5.0.0: {} - semver@7.8.1: {} + semver@7.8.5: {} string-width@7.2.0: dependencies: