CHANGELOG.md

Changelog

5.5.6 (2026-07-22)

Bug Fixes

• docs: resolve real broken markdown links, drop temporary link-check excludes (#500) (c6103e6)

5.5.5 (2026-07-22)

Bug Fixes

• release-please: exclude manifest file from root path tracking (#497) (ec50488)

5.5.4 (2026-07-22)

Bug Fixes

• cli: restore correct version again after second regression, re-anchor for release-please (#493) (22171ed)

5.5.3 (2026-07-22)

Bug Fixes

• cli: restore correct version after release-please regression (#488) (047bcb2)

5.5.2 (2026-07-22)

Bug Fixes

• cli: add license and keywords for the npm package page (691c1c3)
• cli: migrate aidd-cli into framework as cli/, full history preserved (daeef56)
• cli: repoint self-references from aidd-cli to framework (601c30c)

Documentation

• framework: reposition readme as agnostic token-optimized framework (#440) (cfaf61b)

Refactoring

• aidd-context: action citations use markdown links, not @ (7661980)
• aidd-context: restructure 10-learn into a 5-action router (#455) (8062400), closes #278 #419

5.5.1 (2026-07-19)

Documentation

• framework: update README title and tagline (653de28)

5.5.0 (2026-07-16)

Features

• aidd-context: cook research and apply actions (#439) (b6cadaf)
• aidd-context: rebuild project-memory as three actions, verified on both hosts (#442) (90b41ed)

Bug Fixes

• framework: worktree-create installs deps so the first commit works (#441) (70645f7)

Miscellaneous

• aidd-ui: sync changelog from next (9764179)
• deps-dev: bump @commitlint/cli from 21.2.0 to 21.2.1 (#438) (fa469bc)
• deps-dev: bump lefthook from 2.1.9 to 2.1.10 (#436) (70a41b2)

Refactoring

• aidd-context: lighten skill authoring flows (#444) (3cf5928)

5.4.2 (2026-07-13)

Documentation

• vcs: add commit cycle guidelines for AI auto commits (#397) (5a70cce)

5.4.1 (2026-07-10)

Bug Fixes

• aidd-context: onboard shows the stack, and its keys are pressable (#428) (3719204)

5.4.0 (2026-07-10)

Features

• aidd-context: rebuild onboard as a token-lean guided tutorial (#425) (5038985)
• hooks: base new worktrees on next (#402) (70d8046)

Miscellaneous

• commitlint: declare the aidd-ui scope, long and short (#423) (abbcbc6)
• deps-dev: bump @commitlint/cli from 21.0.2 to 21.2.0 (#361) (3374194)
• deps-dev: bump @commitlint/config-conventional (#362) (ecc0e55)
• deps-dev: bump js-yaml from 5.0.0 to 5.2.1 (#401) (c0b57d3)
• framework: type issues instead of labelling them (#422) (9b6651e)
• release main (#405) (4d9412c)

Documentation

• framework: clarify README pitch, terms, and install list (#409) (4fadaed)
• framework: clarify README pitch, terms, and install list (#410) (8d250b6)
• framework: describe the board we actually run (#424) (df6c032)
• framework: rework the documentation — install-first, concise, emoji-styled (#407) (6c0914a)

Refactoring

• remove per-skill README.md mirrors (#302) (#396) (1b94c3c)

5.3.1 (2026-07-07)

Miscellaneous

• release main (#393) (426c604)

5.3.0 (2026-07-06)

Features

• aidd-context: rebuild onboard as an AIDD project linter + runner (fdf7ba5)
• framework: read action files before running, across all skills (#389) (9d592a6)

5.2.2 (2026-07-01)

Miscellaneous

• framework: require one review on next (3279df3)

Documentation

• framework: sync release-flow docs with reality (34a3d1f)

5.2.1 (2026-07-01)

Bug Fixes

• dev: close review report contract gaps (29d99c6)
• dev: critical functional severity and skipped-axis visibility (810be09)
• dev: make functional findings and verdict rules consistent (4c0ac84)

5.2.0 (2026-07-01)

Features

• dev: enforce the review report section set with a validator (befe416)

Bug Fixes

• framework: guarantee and report Claude agent copy on reload (#375) (2f37bab)

Refactoring

• framework: strict anti-slop templates and review redesign (153ba42)

5.1.1 (2026-06-30)

Miscellaneous

• aidd-ui: reset version to 0.1.0-alpha.0 (726a8a0)

5.1.0 (2026-06-30)

Features

• aidd-dev: route deletions to refactor cleanup with orphan sweep (#328) (2c75d0d)
• aidd-ui: scaffold alpha plugin (0.1.0-alpha.0) (#319) (a56792a)
• aidd-vcs: add repo-init skill (init + publish a repository) (#269) (81115da)
• framework: add markdown link checker (#307) (efbc759)
• onboard: phase 1 — read-once loop with a session ledger (c17d38c)
• onboard: phase 2 — foundation gate, skippable (2712c17)
• onboard: phases 3-4 — capability map + project-adapted menu (8ec202b)
• skills: sync argument hints (#296) (5aa9216)

Bug Fixes

• aidd-vcs: sync pull-request skill contract with prefix routing (#326) (2db0005)

Miscellaneous

• deps: target next instead of main for dependabot (#324) (06c1e93)

Documentation

• aidd-context: unify and trim agent instruction template (#329) (d3fe2ac)
• framework: add dominance checks to review and rules (#313) (80daf0d)
• framework: unify change taxonomy into one source of truth (#325) (a42cc5b)
• onboard: brainstorm + validated plan for the onboard refactor (a409d49)
• onboard: refresh README for the snapshot+ledger+menu flow (7bf212b)

Refactoring

• aidd-context: dedupe project-memory templates and lighten actions (#347) (f2a252b)
• aidd-dev: redesign 01-plan into gather/explore/wireframe/plan (#271) (dba017e), closes #292 #265 #276
• aidd-refine: align skills with skill contract (#327) (bc69310)
• conform remaining skills to the authoring contract (#334) (dcc232a)
• framework: executor/checker agents + SDLC orchestration redesign (#314) (7df7a34)
• onboard: slim 03-act, drop colon from the description (71e09ff)
• skills: forbid colon and em dash in descriptions, codify in R5 (1407a9a)

5.0.3 (2026-06-23)

Miscellaneous

• deps-dev: bump js-yaml from 4.2.0 to 5.0.0 (#322) (f71bdd2)

5.0.2 (2026-06-22)

Miscellaneous

• framework: add setup guardrails and pet asset (#310) (ab317e8)

5.0.1 (2026-06-22)

Documentation

• aidd-context: add explicit-scoped-includes rule (R13) to skill-generate (#309) (527e646)
• framework: README star CTA, roadmap, star history + fix dead Discord link (#312) (032f4f0)

5.0.0 (2026-06-19)

⚠ BREAKING CHANGES

• framework: auto-routing is removed. Skills are now manual-invoke only; the prompt-to-skill routing hint no longer runs.

Features

• aidd-context: add cook skill for recipe how-to sheets (#281) (da350b4)
• aidd-context: per-artifact context generators (skill, rule, agent, command, hook) (#264) (647fe5a)
• aidd-dev: add 10-todo skill for parallel todo fan-out (#262) (c086e05)
• aidd-dev: track plan lifecycle status in frontmatter (#251) (3f63ae2)
• framework: remove evals system end-to-end (#261) (9a3c1b8)
• framework: rolling weekly release model (main/next) (#308) (2908b7a)

Bug Fixes

• framework: make reload installs via the CLI from the local clone (#299) (9799b8b)
• framework: make setup work in worktrees (b560fd9)
• framework: use node validators in hooks (#295) (e6b8355)

Miscellaneous

• framework: allow full access in worktrees (#306) (15e279b)
• framework: enable local AIDD plugins for repo dogfooding (#247) (3564872)
• framework: make-based dev workflow (setup, reload, check) (#273) (844989c)
• framework: rename repository URLs aidd-framework to framework (#266) (7cfc0a3)
• framework: share Codex worktree setup (a40fca1)
• framework: stop shipping .mcp.json, recommend MCP servers in README (#263) (e602fa0)

Documentation

• aidd-context: refresh plugin README for the reworked skills (#285) (fdd7bc0)
• contributing: local testing guide, PR template overhaul, and label guide (#244) (cc5c090)
• framework: add a human self-review attestation to the PR template (#249) (c3beb5d)
• framework: add plugin concern taxonomy and skill placement rules (#248) (c6b474f)
• framework: streamline README, add recipes, extract marketplace doc (#280) (a139b52)

Refactoring

• aidd-context: conform 09-mermaid to the skill contract (#286) (4d8e942)
• aidd-context: rebuild 00-onboard as a plain-language guide (#284) (5d7351a)
• aidd-context: rebuild 11-discovery as 11-explore (#287) (c16a397)
• aidd-context: rework 10-learn around scoring and explicit confirm (#282) (89935c0)
• aidd-context: rework project-memory skill with capability model (#279) (a0e8da7)
• aidd-refine: rebuild brainstorm as a deep conversational prober (#298) (51a86b5)

4.4.1 (2026-06-04)

Bug Fixes

• ci: build per-tool dist outside source tree (#196) (7fd66f8)

4.4.0 (2026-06-04)

Features

• ci: build and attach per-tool framework distributions on release (#188) (7f94c82)

Documentation

• framework: add maintainers guide (#184) (09dc949)
• framework: sync aidd_docs with current skill catalog for OSS release (#187) (bebcac3)

4.3.1 (2026-06-04)

Miscellaneous

• deps-dev: bump @commitlint/cli from 21.0.1 to 21.0.2 (#175) (61fedcd)
• deps-dev: bump @commitlint/config-conventional (#178) (5ad7d74)
• deps-dev: bump lefthook from 2.1.6 to 2.1.9 (#176) (d2b28ad)
• framework: require DCO check and add admin PR-bypass to main ruleset (#181) (44704e4)
• reviewing rules (6cd310a)

Documentation

• framework: re-enable release and CI badges for public launch (55d6d96)

4.3.0 (2026-06-03)

Features

• aidd-dev: expand refactor into a 4-axis router with push-only audit handoff (#169) (5c5272e)

Bug Fixes

• aidd-context: lift project-init tool selection into a flow-entry gate (#165) (6fe2d07)
• aidd-dev: enforce mandatory SDLC steps so weak-model hosts cannot skip review (#171) (7037fdb)
• aidd-dev: make review coherent - dedup templates, 3-level severity, read-only identity (#170) (a022a1a)
• framework: make all 31 skill names spec-compliant (kebab, folder-matched, no colons) (#172) (a47505f)

Miscellaneous

• framework: prepare repository for open-source launch (35b20ae)

Documentation

• rewrite v3.9.1 to v4.x upgrade guide with accurate command-to-skill mapping (f041acd)

4.2.0 (2026-05-29)

Features

• aidd-context: multitool discovery - detect/propose/confirm gate + per-tool scan (#162) (43d18f0)
• aidd-context: re-scope 00-onboard to AIDD-wide project onboarding hub (#153) (935e37c)
• aidd-dev: restructure audit into a read-only 7-pillar router (#164) (4b3a37b)

Bug Fixes

• aidd-dev: add routing dispatch to choice-router skills for weak-model hosts (#163) (148b6e3)

Refactoring

• aidd-context: unify 03-context-generate on Model Y tool-resolution (#155) (09e3c56)

4.1.1 (2026-05-22)

Documentation

• aidd-context: document seven artifacts and tool-agnostic wording (7f57ec9)
• aidd-context: document seven artifacts and tool-agnostic wording (5594ec8)

4.1.0 (2026-05-21)

Features

• aidd-refine: add fact-check skill (#140) (8b1eb77)

Bug Fixes

• aidd-orchestrator: correct broken link to 02-ask-config action (#142) (256c4f4)
• aidd-orchestrator: write to-review as a label, not a command (#143) (971fd9d)

Miscellaneous

• ci: drop aidd-cli from release, ship clean marketplace + plugin zips (59e4e8d)
• ci: stop using aidd-cli for release assets, ship a clean marketplace bundle (9ecbf68)
• release-please: drop per-plugin release-as pins after the v4.0.0 cut (48d283e)
• release-please: drop per-plugin release-as pins after v4.0.0 (ae5d16d)
• repoint auto-add workflow to AIDD Roadmap project (#8) (#150) (b7f4e8a)

Documentation

• fix coherence defects in README, docs, and plugin READMEs (7bb04ac)
• fix coherence defects in README, docs, and plugin READMEs (afcbca3)

4.0.0 (2026-05-19)

Features

• aidd-context: add 00-onboard skill (state-aware guided loop) (4f3d0fa)
• aidd-context: add 01-bootstrap skill for SaaS architecture imagination (4643594)
• aidd-context: extend 06-discovery with rule, hook, and memory finders (3ad5661)
• aidd-context: extend context-generate with plugins, commands, hooks, marketplaces; add async-dev router (d409bab)
• aidd-context: implement interactive brainstorming skill with structured actions for clarifying feature requests (edba00c)
• aidd-context: migrate commands to numbered actions (324357a)
• aidd-dev: add 02-implement skill, renumber downstream skills (16fa5d6)
• aidd-dev: add interactive mode to 00-sdlc orchestrator (8f9e245)
• aidd-dev: centralize agents (7f77514)
• aidd-dev: enhance pre-flight checklist with user input markers for unresolved dependencies (a8f41c6)
• aidd-dev: migrate commands to numbered actions (8ef0f8e)
• aidd-dev: scan rules and project files modifications in plan template (0509421)
• aidd-orchestrator: action 08 prints inline how-to-generate guides per secret (ac64f33)
• aidd-orchestrator: add async orchestration plugin (58b7318)
• aidd-orchestrator: add local-mode poll script + drop default agent (5253065)
• aidd-orchestrator: branch enforcement, comment passthrough, skip routing (4d3acc8)
• aidd-orchestrator: branch enforcement, comment passthrough, skip routing (3a5cec0)
• aidd-orchestrator: clean v1.0.0 — to-X / claude/Y label split, drop superflu (26851ec)
• aidd-orchestrator: drop OS cron, route local scheduling via Claude Code (1b6ec12)
• aidd-orchestrator: local daemon path bypasses Claude Code Tasks quota (2d573f3)
• aidd-orchestrator: per-developer Anthropic account routing in remote mode (837857d)
• aidd-orchestrator: setup skill goes end-to-end (5 new actions) (9d4628c)
• aidd-orchestrator: smoke test uses a throwaway issue, never the user's backlog (84596ac)
• aidd-pm: scaffold RC skills with actions (22fc883)
• aidd-refine: add shadow-areas gap analyzer skill + evals CI (0a731ad)
• aidd-vcs: add plugin with 4 VCS skills (commit, pull-request, release-tag, issue-create) (84234de)
• aidd-vcs: support /commit push inline argument (ee4dda6)
• async-dev router + context-generate determinism tightening (#128) (213a82e)
• enhance auto-implement skill with detailed orchestration rules and process steps (c7b991b)
• framework: delete legacy commands/ directory (dac60bb)
• framework: migrate 5 pre-refactored skills into plugins (da2987c)
• framework: refactor to marketplace plugin architecture and skills (27128a9)
• framework: relocate templates and conventions into skill assets (6920182)
• framework: scaffold 4-plugin marketplace catalog (7be5466)
• framework: split MCP and SessionStart hook into plugins (527f9b8)
• framework: update build script for plugin layout and regenerate catalogs (ea18188)
• new generate_skills (d288e9f)
• new status and spec templates from openai long running task (4ed3947)
• orchestrator: add github_write_auth dimension to setup skill and workflow (897754b)
• plugin: publish aidd framework as Claude Code plugin (c913480)
• update agent descriptions for clarity and role specificity in CATALOG and agent files (eabaf0f)
• update ARCHITECTURE.md with new project structure and decisions for skills organization (e8f6442)
• update CATALOG.md with new actions, assets, and references for generate-skill (07d3d3e)

Bug Fixes

• aidd-context: correct hooks.json format for Claude Code and Copilot (f66ca72)
• aidd-context: rename skill frontmatter name from generate-skill to context-generate (805cf6f)
• aidd-context: repair @-paths, generalize mermaid reference, delegate frontmatter to references (1ff4a04)
• aidd-context: replace placeholder with generic path pattern in copilot rule example (e22b358)
• aidd-dev: enforce skill-in-agent rule — orchestrator never loads skills directly (8957d1d)
• aidd-orchestrator: action 07 detects project/user scope before prompting (d84b514)
• aidd-orchestrator: action 07 skips when plugins already loaded (project or user scope) (e9739bb)
• aidd-orchestrator: cosmetic — run_id fallback + dedup review summary (2734e05)
• aidd-orchestrator: delegate-sdlc owns push + PR creation; SDLC writes code only (fcfdac4)
• aidd-orchestrator: forbid leaking action 06 internals into SDLC prompt (5243f31)
• aidd-orchestrator: forbid leaking action 06 internals into SDLC prompt (f933193)
• aidd-orchestrator: iter-1 review never stops on human comment; delegate enforces no-push-to-main (35753a4)
• aidd-orchestrator: make audit + finalize self-verifying (8972d86)
• aidd-orchestrator: outcome decided by observation, not by the agent (4273e0e)
• aidd-orchestrator: scheduling defaults to Desktop (1min min); cloud routine min 1h (6005096)
• aidd-orchestrator: sdlc owns push + PR; orchestrator dictates the contract and verifies (840c248)
• aidd-orchestrator: self-verifying audit + finalize (8f45f13)
• aidd-orchestrator: skip audit push when no PR; drop orphan .json on main (9e9dca4)
• aidd-orchestrator: unbreak workflow YAML (alias parsing on marker bodies) (243f234)
• aidd-orchestrator: YAML post-step observes reality when agent forgets (e24d6a6)
• aidd-orchestrator: YAML post-step observes reality when agent forgets (c3a3405)
• ci: unblock failing workflows (evals validator + codeql gate + commit SHAs) (8f76a43)
• framework: accept short plugin scopes and marketplace in commitlint enum (cd477f6)
• framework: add version field to catalog entries (c64a2cb)
• framework: add version field to each plugin catalog entry (26888af)
• framework: correct slash command naming in docs (adad60a)
• framework: namespace frontmatter for relocated skills (ea220a1)
• framework: repair broken @-paths, stale skill ref, and Ressources typo across plugins (558bb34)
• framework: repair internal broken markdown links (8ae9dc1)
• framework: replace relative plugin links with absolute GitHub URLs in aidd_docs/README.md (d171001)
• framework: wire SDLC contracts — namespace, plan paths, commit modes, validator semantics (f5f14e0)
• orchestrator: enforce SDLC delegation + persist audit log on PR branch (8f5ed79)
• plugin: scope aidd plugin to skills only + fix YAML frontmatter (3779e6e)
• update flowchart direction in README for improved clarity (563bf6c)

Miscellaneous

• aidd-context: refresh stale async-dev refs in project-init template and routing evals (13a424c)
• aidd-refine: clean up shadow-areas evals and catalog (f577db6)
• ci: SHA-pin every external action and add CodeQL workflow (66d5fcf)
• commitlint: scope-enum back as warning with broader list (da0b9ec)
• deps: bundle all open Dependabot upgrades (eb40257)
• deps: bundle all open Dependabot upgrades (3bc18de)
• framework: add aidd-refine and aidd-orchestrator to commitlint scope-enum (6416e1a)
• framework: add OSS standard files (LICENSE, SECURITY, CoC, PR template) (7cd0a69)
• framework: adopt release-please monorepo with per-plugin versioning (9706606)
• framework: align release tarball flow with v5 framework layout (a5601f7)
• framework: bulk alignment — evals everywhere, em-dash purge, audit template, stale refs fixed (0dfd79d)
• framework: bump aidd-pm to 1.0.0 and apply audit fixes (97573bc)
• framework: bump marketplace to 4.0.0 and refresh aidd-dev SDLC docs (073a4a6)
• framework: disable body-max-line-length, keep scope-enum strict (4a6a22f)
• framework: disable proposed MCP servers by default (785293b)
• framework: disable scope-enum to unblock CI on existing commits (5ed4947)
• framework: disable subject-case to unblock CI (4889ce5)
• framework: downgrade scope-enum to warning and disable body-max-line-length (157a8e1)
• framework: drop auto-generated CATALOG.md (6004359)
• framework: drop scope-enum whitelist, keep classic conventional rules (189963f)
• framework: drop skills.json aggregator (671fef8)
• framework: merge feat/plugin-content-tool-agnostic (11cce19)
• framework: merge feat/readme-wow into main (8f42cfc)
• framework: merge origin/feat/plugin-architecture (0082b4c)
• framework: prune stale tracked files and tighten ROADMAP (33975d6)
• framework: raise header-max-length to 120 and downgrade to warning (4bccb58)
• framework: regenerate aidd-dev CATALOG.md after merge (0639dc0)
• framework: regenerate plugin catalogs after aidd-context audit (7b5907a)
• framework: regenerate plugin catalogs after audit sweep (448b111)
• framework: release as 4.0.0 (5b0fc9d)
• framework: remove $schema ref from marketplace.json — CLI owns validation (ae78847)
• framework: remove PostToolUse hook from hooks configuration (0b1eb66)
• framework: restore strict commitlint rules after history rewrite (220e249)
• framework: roll back root version to 3.9.1 for release-please cut (a2535e7)
• framework: self-host summarize-markdown.mjs for per-plugin CATALOG (ee62862)
• framework: tighten standalone lefthook checks + schema validation (749dc5c)
• framework: trigger ci recheck after history rewrite (391760e)
• framework: unify version management across marketplace and plugins via release-please (85d97eb)
• framework: verify build-dist.sh against beta.23 + add verification report (1222e99)
• framework: wave 1 audit fixes (schemas, gitignore, dependabot, links) (4bcb670)
• framework: wave 5 OSS hygiene on main (evals CI + doctor + labels + scrub routing) (8a4c409)
• governance: commit main branch protection ruleset + document policy (160c457)
• orchestrator: drop empty orphan audit unknown-20260514T082959Z (17f0b48)
• orchestrator: record async run audit (12a7e68)
• orchestrator: record async run audit auto-20260514T155557Z-i81 (68119d2)
• orchestrator: record async run audit unknown-20260514T082959Z (cffd669)
• refresh stale references to deleted async-dev skills + three-artifact context-generate (4697d19)
• release-please: pin each plugin to release-as 1.0.0 for the v4 marketplace release (7d0f154)
• release-please: pin plugins to release-as 1.0.0 for v4 marketplace cut (e58021d)
• release-please: register orchestrator + refine and bump root to 4.0.0 (86fed82)
• release-please: ship aidd-pm as 1.0.0 stable (624c20f)
• release-please: ship aidd-pm as 1.0.0 stable (not RC) (d7e962a)
• strip obsolete config/, aidd_docs/, and build-dist.sh (c381602)

Documentation

• aidd-context: fix [1.3] skill name to match SKILL.md frontmatter (generate-skill) (9d4192b)
• aidd-context: refresh descriptions to cover all seven generated artifacts (8cbb5a2)
• aidd-context: refresh descriptions to cover the seven generated artifacts (b1bef44)
• aidd-dev: drop stale reference to 05-ship precondition in SDLC rule (69853d7)
• aidd-orchestrator: rewrite README with full local + remote coverage (ac3b47e)
• aidd-pm: sync CATALOG.md with current skill state (44a398e)
• contributing: document commit scope to release-please mapping (01dc226)
• contributing: point at validate.yml after evals.yml consolidation (6e10a3b)
• framework: add agents count to stats line (e35c7fa)
• framework: add AIDD logo asset (34d1253)
• framework: add ARCHITECTURE.md — source of truth for plugin structure (6135b11)
• framework: add badges, contributors mosaic, and demo-gif placeholder (0726cbe)
• framework: add FAQ, Architecture, Create Plugin guides; clean broken refs (d9a3c24)
• framework: add founder blog link to credit line (7ad6c53)
• framework: add GOVERNANCE, ROADMAP, and skills.json aggregator (e770862)
• framework: add Made in France badge and footer signature (a0d70b3)
• framework: add maintainer release playbook (e80415a)
• framework: add maintainer release playbook (b74fe5b)
• framework: add per-plugin CATALOG.md (auto-generated) (d613282)
• framework: add v3 to v4 upgrade guide (63a9419)
• framework: add v3 to v4 upgrade guide (594f8db)
• framework: clarify onboard skill scope in Quick start (af8d6ef)
• framework: document prerequisites for users and contributors (074c76c)
• framework: drop contributors section, add 4 static badges (9875a73)
• framework: drop evals badge and quick-start mermaid (fb042b4)
• framework: drop orphan aidd_docs/CATALOG.md (c0bb1e2)
• framework: explicit positioning vs claude-plugins-official (dc395b2)
• framework: fix YouTube link and credit Alex Soyes as founder (16449f1)
• framework: keep only static badges and link contributors graph while repo is private (a60b09f)
• framework: reframe AI-Driven Dev section as community + flow + tools (e64d323)
• framework: replace founder YouTube link with GitHub, LinkedIn, X (34076ed)
• framework: rewrite for plugin marketplace model (9529d4c)
• framework: rewrite ROADMAP around user-stated direction (bc581d6)
• framework: rewrite top-level README for OSS readiness (f8eb385)
• framework: scaffold aidd_docs and replace ARCHITECTURE.md (3a91267)
• framework: sync READMEs and CATALOGs with current skills (16c9372)
• framework: update CATALOG.md (d921bfd)
• framework: update feature request template and contributing guidelines (1592df3)
• framework: wow README hero, plugin grid, quick-start Mermaid (bcbd00c)
• orchestrator: add async-dev lifecycle state diagram to run skill README (ac4c867)
• orchestrator: align README with sibling plugin pattern + add to framework catalog (7c62edd)
• orchestrator: restructure plugin and per-skill READMEs (cb841de)
• phase 1 critical audit fixes (skill invocations, catalog, templates) (5b5342b)
• phase 2 high-severity audit fixes (security, lefthook, accuracy) (95f29c3)
• phase 3 medium/low audit fixes (OSS scaffolding, UX, accuracy) (5e43650)
• propagate per-skill README pattern across all plugins (4427e3e)
• readme: bump skill count 32 to 33 (87d2324)
• readme: bump skill count 32 to 33 (14a724a)
• scrub cross-plugin references from skill READMEs (9c23973)

Refactoring

• aidd-context: align audit fixes across 04-mermaid, 01-bootstrap, 02-project-init, 03-context-generate, 05-learn (8f69261)
• aidd-context: cross-tool prompts, .gitkeep enforcement, plugin-based README, CONTRIBUTING (04e74c6)
• aidd-context: merge 09-generate-skill into 03-context-generate with skills/ subfolder (e9aa546)
• aidd-context: remove architecture-generate skill and renumber project-init to 02 (1e80beb)
• aidd-context: restructure project init (da90ed8)
• aidd-dev: restructure 00-sdlc as router with 5 atomic actions (b9653b7)
• aidd-dev: rewrite SDLC as pure orchestrator with role-based agents (dbc6edd)
• aidd-orchestrator: observe-reality + YAML-owned lifecycle (5b64b4a)
• aidd-orchestrator: observe-reality verification + YAML-owned lifecycle (d193b99)
• aidd-pm: restructure spec into build and refine actions, sync plugin docs (107241e)
• aidd-vcs: rewrite skills to canonical template with tool-agnostic process (661f73b)
• framework: align sdlc orchestrator and sub-skills around alex baseline (92535cd)
• framework: canonical action shape, model-A rules, plugin audit sweep (29ef579)
• framework: canonical template for aidd-pm skills + tighter SKILL.md descriptions (0ea9b80)
• framework: extract meta-cognition skills into dedicated plugin (2bf0b6e)
• framework: make content tool-agnostic and self-contained (84165a9)
• framework: move ide-mapping rules to aidd-context plugin (791ac84)
• framework: remove embedded skill content for distribution-mode migration (ee43a32)
• framework: rename skill folders from [X.X] to NN-name format (c8968bc)
• framework: unify plan/status/tracking into living plan template (180c504)
• generate_skill (4a8e9bb)
• plugin: rename aidd-async-dev to aidd-orchestrator (4cb0f71)
• plugin: suffix skill names with -async-dev for self-documentation (c19a5a4)

3.9.1 (2026-04-23)

Bug Fixes

• ci: include base MCP servers in per-tool release tarballs (01de4ab)
• commands: align review_functional with behavioral review intent (d1b6d94)
• commands: align review_functional with behavioral review intent (f0d27eb), closes #72

3.9.0 (2026-04-22)

Features

• config: split vscode and copilot settings into separate directories (f0e585e)
• config: split vscode and copilot settings into separate directories (826207b)

Bug Fixes

• ci: update build-dist.sh for --ai/--ide CLI flags and vscode bundling (c2860e4)
• docs: replace hardcoded .claude paths with {{TOOLS}} placeholder (f5902f6)
• template: complete truncated task placeholder in plan.md (088b1d7)
• template: complete truncated task placeholder in plan.md (5afde32)
• template: complete truncated task placeholder in plan.md (f4dd9fc)

3.8.1 (2026-04-15)

Bug Fixes

• commands: make VCS/ticketing references provider-agnostic (df4e7cc)
• commands: make VCS/ticketing references provider-agnostic (bf50a79)
• commands: move CLI/MCP preference to vcs.md memory template (7756e04)
• commands: separate VCS and ticketing abstractions (5f89bd0)
• init: add missing @ prefix to agents_coordination.md reference (54889e0)
• init: add missing @ prefix to agents_coordination.md reference (ca63160)
• memory: remove inline annotations from vcs.md template (b55c775)

3.8.0 (2026-04-05)

Features

• onboard: add /onboard wizard command for new users (17e7b5c)
• onboard: add /onboard wizard command for new users (b02e173), closes #33

Bug Fixes

• build-dist: use aidd setup --tools to include docs in dist (f99a84c)
• memory: make update_memory.js ESM-compatible with dynamic imports (e671211)
• memory: make update_memory.js ESM-compatible with dynamic imports (0b0f68e)

Documentation

• remove discord README from main, belongs on feat/pm only (435482f)

3.7.3 (2026-03-24)

Bug Fixes

• ci: update build-dist.sh to use current CLI API (29b301a)
• memory: convert update_memory script to CommonJS and add ls fallback (5a31567)

Documentation

• add reporting issues section with issue templates (428bfc0)
• release: add pm.2 discord README and CHANGELOG entry (1beba46)
• rules: add frontmatter description to ide-mapping files (eb1dd38)

3.7.1-pm.2 (2026-03-22) - Beta pre-release

⚠️ Pre-release expérimentale. Pas proposée automatiquement aux utilisateurs existants. Install : aidd setup --release v3.7.1-pm.2 ou aidd update --release v3.7.1-pm.2

Cette release expérimente une approche différente : agents et skills plutôt que commandes SDLC. Chaque agent orchestre ses propres skills avec des gates de challenge intégrées. Rien n'est ancré - feedback et itérations bienvenus.

Features

• pm: add brownfield and greenfield workflow commands (/brownfield, /greenfield)
• agents: add Oriane (PM), Ariane (Architect), Diane (UX), Eva (Impact), Justine (Challenger), Claire (Clarity)
• skills/pm: add pm-constitution, pm-product-brief, pm-prd, pm-user-stories, pm-system-overview, pm-change-brief, pm-change-spec
• skills/arch: add architecture-decision, architecture-milestones, architecture-impact, architecture-impact-plan
• skills/ux: add ux-design-system, ux-flow-map, ux-accessibility, ux-copywriting, ux-audit (greenfield)
• skills/ux: add ux-design-system-update, ux-flow-update, ux-accessibility-update, ux-copywriting-update (brownfield)
• skills: add spike for time-boxed investigations (available to all agents)
• skills: add challenge-methods with 7 structured challenge techniques
• templates/pm: add brief, discovery_package, persona, milestones, gap_report templates

Improvements

• Challenge gates on every skill - structural validation before presenting any deliverable
• Upstream reconciliation (bidirectional): deduplication + constraint propagation
• Business-level language enforced in pm-constitution
• Agent single-responsibility strictly enforced, aligned with course materials

Bug Fixes

• Restore create_user_stories command removed during rebase
• Remove duplicate challenge skill

3.7.2 (2026-03-20)

Bug Fixes

• ci: include .aidd in per-tool tarballs (7f56c21)

3.7.1 (2026-03-19)

Bug Fixes

• plan: remove implementation references from steps (4637864)

3.7.0 (2026-03-19)

Features

• memory: add update_memory script and sync <aidd_project_memory> block (ebaca02)
• memory: add update_memory script and sync aidd_project_memory block (f950ee5)

3.6.0 (2026-03-16)

Features

• tooling: add opencode to build-dist script (cb8a1a7)

3.5.0 (2026-03-16)

Features

• tooling: add OpenCode config and syntax reference (a70f3d0)

3.4.4 (2026-03-10)

Bug Fixes

• remove unnecessary metadata from IDE mapping files (839d8f1)

Documentation

• contributing: clarify which commit types appear in changelog (501ff07)

3.4.3 (2026-03-10)

Documentation

• update README links to use relative paths and remove unnecessary markdown block (2ff99ec)

3.4.2 (2026-03-09)

Miscellaneous

• remove sync-dist.js replaced by aidd-cli (a78e004)

3.4.1 (2026-03-09)

Bug Fixes

• use PACKAGES_TOKEN secret for GitHub Packages auth (7785719)

3.4.0 (2026-03-09)

Features

• replace sync-dist.js with aidd-cli for dist generation (a2815a6)
• replace sync-dist.js with aidd-cli for dist generation (6fe6b3b)

3.3.4 (2026-03-09)

Bug Fixes

• update link to CATALOG.md in README (6a9c2e7)
• update links to CATALOG.md in README for consistency (5990084)

3.3.3 (2026-03-07)

Bug Fixes

• link to coding assertions documentation (593f3ad)

3.3.2 (2026-03-06)

Bug Fixes

• update flowchart in README for clarity and accuracy (8bd7e6f)

Documentation

• update CONTRIBUTING and README to clarify versioning and release process (843ba73)

CI

• add commitlint pre-commit hook and GitHub Actions workflow (9c9711c)
• make pre-commit and pre-push hooks blocking (39dddcd)
• rename commitlint config to .cjs (9b881bb)
• update commitlint workflow to use .cjs config (66d0485)

3.3.1 (2026-03-05)

Bug Fixes

• correct broken agents coordination guide link in aidd_docs README (72985d0), closes #7

3.3.0 (2026-03-05)

Features

• add golden principles for agent guidelines (3e84550)

Bug Fixes

• clarify mermaid node ID and label naming rules (94f4611), closes #10
• correct review_code template path from aidd/ to dev/ (4118de9), closes #11
• exclude non-essential files from release tarball (a4871f2)
• remove empty templates/ from tarball include list (d06ac8b)
• switch tarball to include-based approach and reset version to 3.2.2 (5a6276c)
• update globs to include Markdown files for Mermaid diagram rules (91727cf)

Build

• exclude dev files from tarball and add version.txt (e25d77d)

Miscellaneous

• main: release 3.2.3 (2ec6412)
• main: release 3.2.3 (d624b9f)
• main: release 3.3.0 (3d56acf)
• main: release 3.3.0 (e5ba343)
• main: release 4.0.0 (e8c3ee2)
• main: release 4.0.0 (584477a)
• reset version to 3.2.2 to bridge gap from deleted malware releases (541e210)

CI

• add statuses write permission to lint-pr workflow (4ad953f)

3.3.0 (2026-03-05)

Features

• add golden principles for agent guidelines (3e84550)

Bug Fixes

• clarify mermaid node ID and label naming rules (94f4611), closes #10
• correct review_code template path from aidd/ to dev/ (4118de9), closes #11
• exclude non-essential files from release tarball (a4871f2)
• switch tarball to include-based approach and reset version to 3.2.2 (5a6276c)
• update globs to include Markdown files for Mermaid diagram rules (91727cf)

Build

• exclude dev files from tarball and add version.txt (e25d77d)

Miscellaneous

• main: release 3.2.3 (2ec6412)
• main: release 3.2.3 (d624b9f)
• main: release 4.0.0 (e8c3ee2)
• main: release 4.0.0 (584477a)

CI

• add statuses write permission to lint-pr workflow (4ad953f)

4.0.0 (2026-03-05)

⚠ BREAKING CHANGES

• move PM commands for approval

Features

• add .gitignore to exclude tool-specific directories (fb7fc1c)
• add ASCII user journey diagram for improved understanding and validation in implementation plans (a2587f0)
• add assert_architecture command to verify code conformity with architecture standards (5e02c67)
• add confidence level prompt to challenge output and update plan rules for configuration preparation (6c5c8e1)
• add generate_architecture command and establish command structure standards (52cc952)
• add golden principles for agent guidelines (3e84550)
• add guideline to split phases based on responsibilities in plan generation (09403fe)
• add INSTALL_README.md template for per-tool dist (0395c0e)
• add JSONC comment stripping and .vscode/settings.json generation for Claude tool (1ddac51)
• add lefthook child-to-parent delegation + auto-install (6527e6d)
• add permissions configuration to settings.json for enhanced security (0ced082)
• add prompt template and update CATALOG reference (ac57bf9)
• add scaffoldEmptyRuleCategories and brand prefix for commands (3cc6dc4)
• add settings.json to configure Gitignore behavior (180d0e9)
• add ticket_info command and remove jira_info command (fb3e494)
• clarify header title definition in Mermaid generation rules (3c2521c)
• enhance documentation for challenge skill and add mermaid generation rules (2e3ab24)
• enhance README structure and clarity with improved formatting and additional sections (a586ac7)
• enhance run_projection documentation to emphasize file architecture relevance (f051c03)
• improve formatting and organization of agent and command sections in README (c3b3286)
• improve formatting and organization of agents and commands sections in README (ae5bc08)
• initial migration of AIDD Framework from monorepo (1785eed)
• new CATALOG and prompt templates (a12e196)
• redraw aidd_docs/ (494a0d3)
• remove improve_prompt and isolate commands from the framework catalog (b969e79)
• remove optional context section from isolate command documentation (ba61286)
• revert prompts template and update CATALOG structure (e2afdff)
• update agent and command documentation for improved clarity and consistency (1ee6d7b)
• update agent models to include new configurations (6dcbc38)

Bug Fixes

• add argument hint and scope section to test iterator prompt (7f8c03a)
• align memory paths, development flows, and phantom command references (dc68610)
• clarify documentation rules and enhance categorization of learnings in learn.md (bdaf1af)
• clarify mermaid node ID and label naming rules (94f4611), closes #10
• correct formatting in CATALOG.md for better readability (d13da18)
• correct review_code template path from aidd/ to dev/ (4118de9), closes #11
• improve formatting of commit type table in README.md for better readability (aac2695)
• refine clarity checklist instructions and remove redundant steps (f23123f)
• remove outdated steps from coding assertions and update reference path (55c2538)
• replace cross-repo relative links with full GitHub URLs (a151ba5)
• update .gitignore to exclude all files in the dist directory (6ef1499)
• update argument hints in CATALOG.md for clarity (353a5e5)
• update coding assertions to include additional examples for clarity (34f765b)
• update globs to include Markdown files for Mermaid diagram rules (91727cf)
• update links in documentation for clarity and consistency (3b802c6)
• update mermaid diagram labels for clarity in README (1680d7e)
• update npm_update function to install latest pnpm using corepack (fa6e313)
• update paths for GitHub Copilot instruction templates (b19430e)

Documentation

• add aidd.sh script with aliases and utility functions for enhanced productivity (7000eac)
• add auto-accept command documentation and enhance VSCode settings (2b6b37c)
• add auto-accept command documentation and update CATALOG.md with framework content (cb8ae2a)
• add changelog and align versioning configuration (9555e46)
• add rules section to audit.md for codebase analysis (bad8dc3)
• add versioning and contribution guidelines (a3d0c25)
• clarify assertion listing in assert.md and add new audit.md for codebase analysis (fbcd4d3)
• enhance behavior guidelines in AGENTS.md for clarity and effectiveness (14623f4)
• extract catalog, translate README and CONTRIBUTING to English (e893bf0)
• simplify file path patterns in ide-mapping files for consistency (1d01ae7)
• update command reference and enhance feature building workflows in README (b70b529)
• update file path patterns in ide-mapping files for consistency (dcae122)
• update generate_rules documentation for clarity and detail (a1493dd)
• update README to enhance clarity and structure (62d1292)

Style

• reformat CATALOG.md table alignment (2389e5f)

Refactoring

• clarify correctness criteria and improve section headings in challenge documentation (6958244)
• codebase audit, remove PM (9665604)
• consolidate templates into aidd_docs and rewrite README (758a7ce)
• enhance clarity in user journey documentation by adding warnings and task instructions (fc9688d)
• enhance implementation guidelines by adding a decisive rule and clarifying agent usage (c55ba37)
• enhance user journey visualization by updating diagram syntax and improving task planning steps (354a985)
• improve VCS guidelines formatting and enhance clarity in plan generation steps (c4e8bfa)
• move PM commands for approval (ff6f7eb)
• move sync-dist build into framework and add per-tool tarballs to release (9949658)
• outsource PM, change folder structure (856fe61)
• standardize naming convention for auto-accept command and enhance catalog documentation (99c515f)
• update descriptions and streamline instruction steps for Alexia and Auto-Implement agents (a50eaf8)
• update descriptions and streamline user story templates (4266090)
• update documentation for Kent and Martin agents, enhance coding assertions, and improve implementation process clarity (ba0ed37)
• update formatting and remove outdated sections in documentation (3ed7064)
• update mcp.json structure and enhance config format validation in tests (e5d8d41)
• update paths in VSCode settings for instruction templates (5772d76)

Build

• exclude dev files from tarball and add version.txt (e25d77d)

Miscellaneous

• add node_modules/ and .specstory/ to .gitignore (bb77d3a)
• main: release 3.0.1 (3fb425b)
• main: release 3.0.1 (aadb50f)
• main: release 3.1.0 (f2db6d0)
• main: release 3.1.0 (64d9c80)
• main: release 3.2.0 (98e6ed1)
• main: release 3.2.0 (a5110f6)
• main: release 3.2.1 (6e468ef)
• main: release 3.2.1 (3ae77ab)
• main: release 3.2.2 (22b10af)
• main: release 3.2.2 (6b411b2)
• main: release 3.2.3 (2ec6412)
• main: release 3.2.3 (d624b9f)
• remove config.yml (e6aaa47)

CI

• add Release Please workflows and configuration (56a96eb)
• add statuses write permission to lint-pr workflow (4ad953f)

3.2.3 (2026-03-04)

Bug Fixes

• clarify mermaid node ID and label naming rules (94f4611), closes #10
• correct review_code template path from aidd/ to dev/ (4118de9), closes #11
• update globs to include Markdown files for Mermaid diagram rules (91727cf)

CI

• add statuses write permission to lint-pr workflow (4ad953f)

3.2.2 (2026-02-27)

Bug Fixes

• update npm_update function to install latest pnpm using corepack (fa6e313)

3.2.1 (2026-02-23)

Bug Fixes

• add argument hint and scope section to test iterator prompt (7f8c03a)
• correct formatting in CATALOG.md for better readability (d13da18)
• improve formatting of commit type table in README.md for better readability (aac2695)
• refine clarity checklist instructions and remove redundant steps (f23123f)
• remove outdated steps from coding assertions and update reference path (55c2538)
• update argument hints in CATALOG.md for clarity (353a5e5)
• update coding assertions to include additional examples for clarity (34f765b)
• update links in documentation for clarity and consistency (3b802c6)

Refactoring

• outsource PM, change folder structure (856fe61)

3.2.0 (2026-02-20)

Features

• add ASCII user journey diagram for improved understanding and validation in implementation plans (a2587f0)
• add assert_architecture command to verify code conformity with architecture standards (5e02c67)
• add confidence level prompt to challenge output and update plan rules for configuration preparation (6c5c8e1)
• add generate_architecture command and establish command structure standards (52cc952)
• add guideline to split phases based on responsibilities in plan generation (09403fe)
• add JSONC comment stripping and .vscode/settings.json generation for Claude tool (1ddac51)
• add lefthook child-to-parent delegation + auto-install (6527e6d)
• enhance documentation for challenge skill and add mermaid generation rules (2e3ab24)
• enhance run_projection documentation to emphasize file architecture relevance (f051c03)
• remove improve_prompt and isolate commands from the framework catalog (b969e79)

Bug Fixes

• update mermaid diagram labels for clarity in README (1680d7e)

Documentation

• add rules section to audit.md for codebase analysis (bad8dc3)

Refactoring

• clarify correctness criteria and improve section headings in challenge documentation (6958244)
• enhance clarity in user journey documentation by adding warnings and task instructions (fc9688d)
• enhance implementation guidelines by adding a decisive rule and clarifying agent usage (c55ba37)
• enhance user journey visualization by updating diagram syntax and improving task planning steps (354a985)
• improve VCS guidelines formatting and enhance clarity in plan generation steps (c4e8bfa)
• standardize naming convention for auto-accept command and enhance catalog documentation (99c515f)
• update descriptions and streamline instruction steps for Alexia and Auto-Implement agents (a50eaf8)
• update documentation for Kent and Martin agents, enhance coding assertions, and improve implementation process clarity (ba0ed37)
• update mcp.json structure and enhance config format validation in tests (e5d8d41)
• update paths in VSCode settings for instruction templates (5772d76)

Miscellaneous

• add node_modules/ and .specstory/ to .gitignore (bb77d3a)

3.1.0 (2026-02-17)

Features

• add scaffoldEmptyRuleCategories and brand prefix for commands (3cc6dc4)

Documentation

• add aidd.sh script with aliases and utility functions for enhanced productivity (7000eac)
• add auto-accept command documentation and enhance VSCode settings (2b6b37c)
• add auto-accept command documentation and update CATALOG.md with framework content (cb8ae2a)
• clarify assertion listing in assert.md and add new audit.md for codebase analysis (fbcd4d3)
• enhance behavior guidelines in AGENTS.md for clarity and effectiveness (14623f4)
• simplify file path patterns in ide-mapping files for consistency (1d01ae7)
• update command reference and enhance feature building workflows in README (b70b529)
• update file path patterns in ide-mapping files for consistency (dcae122)
• update generate_rules documentation for clarity and detail (a1493dd)
• update README to enhance clarity and structure (62d1292)

Refactoring

• codebase audit, remove PM (9665604)
• consolidate templates into aidd_docs and rewrite README (758a7ce)
• move sync-dist build into framework and add per-tool tarballs to release (9949658)

3.0.1 (2026-02-12)

Documentation

• add changelog and align versioning configuration (9555e46)
• add versioning and contribution guidelines (a3d0c25)

Miscellaneous

• remove config.yml (e6aaa47)

3.0.0 (2026-02-12)

Initial release of the AIDD Framework as a standalone repository with automated versioning.

Features

• initial migration of AIDD Framework from monorepo (1785eed)
• add settings.json to configure Gitignore behavior (180d0e9)
• update agent models to include new configurations (6dcbc38)
• add permissions configuration to settings.json for enhanced security (0ced082)
• clarify header title definition in Mermaid generation rules (3c2521c)
• remove optional context section from isolate command documentation (ba61286)
• add INSTALL_README.md template for per-tool dist (0395c0e)
• add .gitignore to exclude tool-specific directories (fb7fc1c)
• redraw aidd_docs/ (494a0d3)
• new CATALOG and prompt templates (a12e196)
• add prompt template and update CATALOG reference (ac57bf9)
• revert prompts template and update CATALOG structure (e2afdff)
• add ticket_info command and remove jira_info command (fb3e494)

Bug Fixes

• replace cross-repo relative links with full GitHub URLs (a151ba5)
• align memory paths, development flows, and phantom command references (dc68610)
• update paths for GitHub Copilot instruction templates (b19430e)
• update .gitignore to exclude all files in the dist directory (6ef1499)

Documentation

• extract catalog, translate README and CONTRIBUTING to English (e893bf0)
• add versioning and contribution guidelines (a3d0c25)

Style

• reformat CATALOG.md table alignment (2389e5f)

Refactoring

• update descriptions and streamline user story templates (4266090)
• update formatting and remove outdated sections in documentation (3ed7064)

Breaking Changes

• move PM commands for approval (ff6f7eb)