@codemcp/ade 0.6.1 → 0.8.0

package/.beads/issues.jsonl

@@ -6,6 +6,32 @@
 {"id":"ade-1.3","title":"Fix","description":"Implement the solution based on your analysis:  - If  exists: Follow the design from it - Otherwise: Elaborate design options and present them to the user  Before implementing, assess the approach: - How critical is this system? What is the blast radius if the fix causes issues? - Should this be a minimal fix or a more comprehensive solution?  Make targeted changes that address the root cause without introducing new issues. Be careful to maintain existing functionality while fixing the bug.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:27:27.697356+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:27:27.697356+01:00","dependencies":[{"issue_id":"ade-1.3","depends_on_id":"ade-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-1.3","depends_on_id":"ade-1.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-1.4","title":"Verify","description":"Test the fix thoroughly to ensure the original bug is resolved and no new issues were introduced. Run existing tests, create new ones if needed, and verify the solution is robust.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:27:27.865128+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:27:27.865128+01:00","dependencies":[{"issue_id":"ade-1.4","depends_on_id":"ade-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-1.4","depends_on_id":"ade-1.3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-1.5","title":"Finalize","description":"Ensure code quality and documentation accuracy through systematic cleanup and review.  **STEP 1: Code Cleanup** Systematically clean up development artifacts: - Remove all temporary debug output statements used during bug investigation (console logging, print statements, debug output functions) - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred - Remove completed TODOs and convert remaining ones to proper issue tracking if needed - Remove temporary debugging code, test code blocks, and commented-out code - Ensure proper error handling replaces temporary debug logging  **STEP 2: Documentation Review** Review and update documentation to reflect the bug fix: - If  exists, update it if design details were refined or changed during the fix - Compare documentation against the actual bug fix implementation - Update only the documentation sections that have functional changes - Remove references to investigation iterations, progress notes, and temporary decisions - Ensure documentation describes the final fixed state, not the debugging process - Ask the user to review document updates  **STEP 3: Final Validation** - Run existing tests to ensure cleanup didn't break functionality - Verify documentation accuracy with a final review - Ensure bug fix is ready for production - Update task progress and mark completed work as you finalize the bug fix","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:27:28.031667+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:27:28.031667+01:00","dependencies":[{"issue_id":"ade-1.5","depends_on_id":"ade-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-1.5","depends_on_id":"ade-1.4","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-10","title":"ade: bugfix (development-plan-fix-docset-writing.md)","description":"Responsible vibe engineering session using bugfix workflow for ade","status":"open","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:23.763416+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:23.763416+01:00"}
+{"id":"ade-10.1","title":"Reproduce","description":"Gather specific information to reliably reproduce the reported bug: - What are the exact OS, browser/runtime versions, and hardware specs? - What is the precise sequence of actions that trigger the bug? - What error messages, logs, or stack traces are available? - Does this happen every time or intermittently? - How many users are affected and what is the business impact?  Create test cases that demonstrate the problem. Document your findings and create tasks as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:23.906213+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:23.906213+01:00","dependencies":[{"issue_id":"ade-10.1","depends_on_id":"ade-10","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-10.2","title":"Analyze","description":"Examine the code paths involved in the bug, identify the root cause, and understand why the issue occurs. Use debugging tools, add logging, and trace through the problematic code. Document your analysis and create tasks as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:24.062362+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:24.062362+01:00","dependencies":[{"issue_id":"ade-10.2","depends_on_id":"ade-10","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-10.2","depends_on_id":"ade-10.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-10.3","title":"Fix","description":"Implement the solution based on your analysis:  - If  exists: Follow the design from it - Otherwise: Elaborate design options and present them to the user  Before implementing, assess the approach: - How critical is this system? What is the blast radius if the fix causes issues? - Should this be a minimal fix or a more comprehensive solution?  Make targeted changes that address the root cause without introducing new issues. Be careful to maintain existing functionality while fixing the bug.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:24.211424+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:24.211424+01:00","dependencies":[{"issue_id":"ade-10.3","depends_on_id":"ade-10","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-10.3","depends_on_id":"ade-10.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-10.4","title":"Verify","description":"Test the fix thoroughly to ensure the original bug is resolved and no new issues were introduced. Run existing tests, create new ones if needed, and verify the solution is robust.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:24.357+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:24.357+01:00","dependencies":[{"issue_id":"ade-10.4","depends_on_id":"ade-10","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-10.4","depends_on_id":"ade-10.3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-10.5","title":"Finalize","description":"Ensure code quality and documentation accuracy through systematic cleanup and review.  **STEP 1: Code Cleanup** Systematically clean up development artifacts: - Remove all temporary debug output statements used during bug investigation (console logging, print statements, debug output functions) - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred - Remove completed TODOs and convert remaining ones to proper issue tracking if needed - Remove temporary debugging code, test code blocks, and commented-out code - Ensure proper error handling replaces temporary debug logging  **STEP 2: Documentation Review** Review and update documentation to reflect the bug fix: - If  exists, update it if design details were refined or changed during the fix - Compare documentation against the actual bug fix implementation - Update only the documentation sections that have functional changes - Remove references to investigation iterations, progress notes, and temporary decisions - Ensure documentation describes the final fixed state, not the debugging process - Ask the user to review document updates  **STEP 3: Final Validation** - Run existing tests to ensure cleanup didn't break functionality - Verify documentation accuracy with a final review - Ensure bug fix is ready for production - Update task progress and mark completed work as you finalize the bug fix","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T14:32:24.515977+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T14:32:24.515977+01:00","dependencies":[{"issue_id":"ade-10.5","depends_on_id":"ade-10","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-10.5","depends_on_id":"ade-10.4","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11","title":"ade: epcc (development-plan-fix-docset-writing.md)","description":"Responsible vibe engineering session using epcc workflow for ade","status":"closed","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:24:52.604251+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:05:42.784077+01:00","closed_at":"2026-03-20T16:05:42.784077+01:00","close_reason":"Closed"}
+{"id":"ade-11.1","title":"Explore","description":"Research the codebase to understand existing patterns and gather context about the problem space.  - If uncertain about conventions or rules, ask the user about them - Read relevant files and documentation - If  exists: Understand and document requirements there - Otherwise: Document requirements in your task management system  Focus on understanding without writing code yet. Document your findings and create tasks as needed.","status":"closed","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:24:52.757158+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:26.864081+01:00","closed_at":"2026-03-20T16:01:26.864081+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.1","depends_on_id":"ade-11","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.2","title":"Plan","description":"Create a detailed implementation strategy based on your exploration:  - If  exists: Base your strategy on requirements from it - Otherwise: Use existing task context  Break down the work into specific, actionable tasks. Consider edge cases, dependencies, and potential challenges.  - If architectural changes needed and  exists: Document in  - Otherwise: Create tasks to track architectural decisions  - If  exists: Adhere to the design in it - Otherwise: Elaborate design options and present them to the user  Document the planning work thoroughly and create implementation tasks as part of the code phase as needed.","status":"closed","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:24:52.917633+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:26.996449+01:00","closed_at":"2026-03-20T16:01:26.996449+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.2","depends_on_id":"ade-11","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-11.2","depends_on_id":"ade-11.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3","title":"Code","description":"Follow your plan to build the solution:  - If  exists: Follow the design from it - Otherwise: Elaborate design options and present them to the user - If  exists: Build according to the architecture from it - Otherwise: Elaborate architectural options and present them to the user - If  exists: Ensure requirements from it are met - Otherwise: Ensure existing requirements are met based on your task context  Write clean, well-structured code with proper error handling. Prevent regression by building, linting, and executing existing tests. Stay flexible and adapt the plan as you learn more during implementation. Update task progress and create new tasks as needed.","status":"closed","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:24:53.084958+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:27.09839+01:00","closed_at":"2026-03-20T16:01:27.09839+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3","depends_on_id":"ade-11","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-11.3","depends_on_id":"ade-11.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.1","title":"types.ts: remove Option.docsets, excluded_docsets from UserConfig, add docset to ProvisionWriter","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.105878+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:13.66361+01:00","closed_at":"2026-03-20T16:01:13.66361+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.1","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.10","title":"catalog/catalog.spec.ts: replace .docsets assertions with recipe-entry assertions","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.43139+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.697048+01:00","closed_at":"2026-03-20T16:01:14.697048+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.10","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.11","title":"cli/setup.ts: remove docset confirmation multiselect block","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.575948+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.807776+01:00","closed_at":"2026-03-20T16:01:14.807776+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.11","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.12","title":"cli/setup.spec.ts: remove docset-related tests","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.720793+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.914569+01:00","closed_at":"2026-03-20T16:01:14.914569+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.12","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.13","title":"cli/knowledge.integration.spec.ts: remove excluded_docsets test","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.87583+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:15.018168+01:00","closed_at":"2026-03-20T16:01:15.018168+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.13","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.14","title":"cli/conventions.integration.spec.ts: remove docset multiselect mock calls","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:50.015271+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:15.119845+01:00","closed_at":"2026-03-20T16:01:15.119845+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.14","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.15","title":"Delete dead files: writers/knowledge.ts and knowledge.spec.ts","status":"closed","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:50.151331+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:13.53949+01:00","closed_at":"2026-03-20T16:01:13.53949+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.15","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.2","title":"writers/docset.ts: new docset provision writer","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.271995+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:13.783381+01:00","closed_at":"2026-03-20T16:01:13.783381+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.2","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.3","title":"writers/docset.spec.ts: unit tests for docset writer","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.410045+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:13.883732+01:00","closed_at":"2026-03-20T16:01:13.883732+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.3","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.4","title":"registry.ts: register docsetWriter","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.546387+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:13.996487+01:00","closed_at":"2026-03-20T16:01:13.996487+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.4","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.5","title":"index.ts: export docsetWriter, remove collectDocsets export","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.680198+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.103166+01:00","closed_at":"2026-03-20T16:01:14.103166+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.5","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.6","title":"resolver.ts: remove docset-collection loop, exclusion filtering, collectDocsets()","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.821344+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.209469+01:00","closed_at":"2026-03-20T16:01:14.209469+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.6","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.7","title":"resolver.spec.ts: update docsets fixtures to recipe entries, remove excluded_docsets tests","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:48.957283+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.316194+01:00","closed_at":"2026-03-20T16:01:14.316194+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.7","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.8","title":"catalog/facets/architecture.ts: replace docsets[] with recipe entries (3 options)","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.150947+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.449139+01:00","closed_at":"2026-03-20T16:01:14.449139+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.8","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.3.9","title":"catalog/facets/practices.ts: replace docsets[] with recipe entry (1 option)","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:45:49.294147+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:01:14.582911+01:00","closed_at":"2026-03-20T16:01:14.582911+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.3.9","depends_on_id":"ade-11.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-11.4","title":"Commit","description":"Ensure code quality and documentation accuracy through systematic cleanup and review. **STEP 1: Code Cleanup** Systematically clean up development artifacts: 1. **Remove Debug Output**: Search for and remove all temporary debug output statements used during development.    Look for language-specific debug output methods (console logging, print statements, debug output functions).    Remove any debugging statements that were added for development purposes.  2. **Review TODO/FIXME Comments**:    - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred    - Remove completed TODOs    - Convert remaining TODOs to proper issue tracking if needed  3. **Remove Debugging Code Blocks**:    - Remove temporary debugging code, test code blocks, and commented-out code    - Clean up any experimental code that's no longer needed    - Ensure proper error handling replaces temporary debug logging  **STEP 2: Documentation Review** Review and update documentation to reflect final implementation: 1. **Update Long-Term Memory Documents**: Based on what was actually implemented:    - If  exists: Update it if requirements changed during development    - If  exists: Update it if architectural impacts were identified    - If  exists: Update it if design details were refined or changed    - Otherwise: Document any changes in the plan file 2. **Compare Against Implementation**: Review documentation against actual implemented functionality 3. **Update Changed Sections**: Only modify documentation sections that have functional changes 4. **Remove Development Progress**: Remove references to development iterations, progress notes, and temporary decisions 5. **Focus on Final State**: Ensure documentation describes the final implemented state, not the development process 6. **Ask User to Review Document Updates** **STEP 3: Final Validation** - Run existing tests to ensure cleanup didn't break functionality - Verify documentation accuracy with a final review - Ensure code is ready for production/delivery Update task progress and mark completed work as you finalize the feature.","status":"closed","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T15:24:53.248593+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T16:05:42.649754+01:00","closed_at":"2026-03-20T16:05:42.649754+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-11.4","depends_on_id":"ade-11","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-11.4","depends_on_id":"ade-11.3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-2","title":"ade: epcc (development-plan-autonomy-facet.md)","description":"Responsible vibe engineering session using epcc workflow for ade","status":"open","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:42:24.649306+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:42:24.649306+01:00"}
 {"id":"ade-2.1","title":"Explore","description":"Research the codebase to understand existing patterns and gather context about the problem space.  - If uncertain about conventions or rules, ask the user about them - Read relevant files and documentation - If  exists: Understand and document requirements there - Otherwise: Document requirements in your task management system  Focus on understanding without writing code yet. Document your findings and create tasks as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:42:24.818903+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:42:24.818903+01:00","dependencies":[{"issue_id":"ade-2.1","depends_on_id":"ade-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-2.1.1","title":"Review existing behavior-oriented facets and catalog tests","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-18T08:46:07.923572+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-18T08:46:37.327782+01:00","closed_at":"2026-03-18T08:46:37.327782+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-2.1.1","depends_on_id":"ade-2.1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
@@ -84,3 +110,14 @@
 {"id":"ade-8.3","title":"Fix","description":"Implement the solution based on your analysis:  - If  exists: Follow the design from it - Otherwise: Elaborate design options and present them to the user  Before implementing, assess the approach: - How critical is this system? What is the blast radius if the fix causes issues? - Should this be a minimal fix or a more comprehensive solution?  Make targeted changes that address the root cause without introducing new issues. Be careful to maintain existing functionality while fixing the bug.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T08:52:50.645347+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T08:52:50.645347+01:00","dependencies":[{"issue_id":"ade-8.3","depends_on_id":"ade-8","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-8.3","depends_on_id":"ade-8.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-8.4","title":"Verify","description":"Test the fix thoroughly to ensure the original bug is resolved and no new issues were introduced. Run existing tests, create new ones if needed, and verify the solution is robust.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T08:52:50.824002+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T08:52:50.824002+01:00","dependencies":[{"issue_id":"ade-8.4","depends_on_id":"ade-8","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-8.4","depends_on_id":"ade-8.3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"ade-8.5","title":"Finalize","description":"Ensure code quality and documentation accuracy through systematic cleanup and review.  **STEP 1: Code Cleanup** Systematically clean up development artifacts: - Remove all temporary debug output statements used during bug investigation (console logging, print statements, debug output functions) - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred - Remove completed TODOs and convert remaining ones to proper issue tracking if needed - Remove temporary debugging code, test code blocks, and commented-out code - Ensure proper error handling replaces temporary debug logging  **STEP 2: Documentation Review** Review and update documentation to reflect the bug fix: - If  exists, update it if design details were refined or changed during the fix - Compare documentation against the actual bug fix implementation - Update only the documentation sections that have functional changes - Remove references to investigation iterations, progress notes, and temporary decisions - Ensure documentation describes the final fixed state, not the debugging process - Ask the user to review document updates  **STEP 3: Final Validation** - Run existing tests to ensure cleanup didn't break functionality - Verify documentation accuracy with a final review - Ensure bug fix is ready for production - Update task progress and mark completed work as you finalize the bug fix","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T08:52:50.99667+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T08:52:50.99667+01:00","dependencies":[{"issue_id":"ade-8.5","depends_on_id":"ade-8","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-8.5","depends_on_id":"ade-8.4","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9","title":"ade: epcc (development-plan-extension-override-skills.md)","description":"Responsible vibe engineering session using epcc workflow for ade","status":"open","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:16:22.460649+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:16:22.460649+01:00"}
+{"id":"ade-9.1","title":"Explore","description":"Research the codebase to understand existing patterns and gather context about the problem space.  - If uncertain about conventions or rules, ask the user about them - Read relevant files and documentation - If  exists: Understand and document requirements there - Otherwise: Document requirements in your task management system  Focus on understanding without writing code yet. Document your findings and create tasks as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:16:22.605996+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:16:22.605996+01:00","dependencies":[{"issue_id":"ade-9.1","depends_on_id":"ade-9","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.2","title":"Plan","description":"Create a detailed implementation strategy based on your exploration:  - If  exists: Base your strategy on requirements from it - Otherwise: Use existing task context  Break down the work into specific, actionable tasks. Consider edge cases, dependencies, and potential challenges.  - If architectural changes needed and  exists: Document in  - Otherwise: Create tasks to track architectural decisions  - If  exists: Adhere to the design in it - Otherwise: Elaborate design options and present them to the user  Document the planning work thoroughly and create implementation tasks as part of the code phase as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:16:22.745983+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:16:22.745983+01:00","dependencies":[{"issue_id":"ade-9.2","depends_on_id":"ade-9","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.2","depends_on_id":"ade-9.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3","title":"Code","description":"Follow your plan to build the solution:  - If  exists: Follow the design from it - Otherwise: Elaborate design options and present them to the user - If  exists: Build according to the architecture from it - Otherwise: Elaborate architectural options and present them to the user - If  exists: Ensure requirements from it are met - Otherwise: Ensure existing requirements are met based on your task context  Write clean, well-structured code with proper error handling. Prevent regression by building, linting, and executing existing tests. Stay flexible and adapt the plan as you learn more during implementation. Update task progress and create new tasks as needed.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:16:22.881145+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:16:22.881145+01:00","dependencies":[{"issue_id":"ade-9.3","depends_on_id":"ade-9","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3","depends_on_id":"ade-9.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.1","title":"Add replaces?: string[] to InlineSkill and ExternalSkill in types.ts","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:56.87809+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:25:09.682568+01:00","closed_at":"2026-03-20T11:25:09.682568+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.1","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.2","title":"Post-process skills in resolver: dedup by name + filter replaced names","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:57.036539+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:25:26.025057+01:00","closed_at":"2026-03-20T11:25:26.025057+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.2","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3.2","depends_on_id":"ade-9.3.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.3","title":"Write resolver tests: replaces dedup, ordering, no-op when replaces empty","status":"closed","priority":1,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:57.182342+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:26:32.609547+01:00","closed_at":"2026-03-20T11:26:32.609547+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.3","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3.3","depends_on_id":"ade-9.3.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.4","title":"Update skillsWriter spec: pass-through of replaces field","status":"closed","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:57.338918+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:27:04.797258+01:00","closed_at":"2026-03-20T11:27:04.797258+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.4","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3.4","depends_on_id":"ade-9.3.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.5","title":"Update writeInlineSkills: ignore replaces field when writing SKILL.md","status":"closed","priority":2,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:57.510647+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:27:13.986652+01:00","closed_at":"2026-03-20T11:27:13.986652+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.5","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3.5","depends_on_id":"ade-9.3.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.3.6","title":"Update ade.extensions.mjs example with replaces declarations","status":"closed","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:21:57.649406+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:28:51.412822+01:00","closed_at":"2026-03-20T11:28:51.412822+01:00","close_reason":"Closed","dependencies":[{"issue_id":"ade-9.3.6","depends_on_id":"ade-9.3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.3.6","depends_on_id":"ade-9.3.2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"ade-9.4","title":"Commit","description":"Ensure code quality and documentation accuracy through systematic cleanup and review. **STEP 1: Code Cleanup** Systematically clean up development artifacts: 1. **Remove Debug Output**: Search for and remove all temporary debug output statements used during development.    Look for language-specific debug output methods (console logging, print statements, debug output functions).    Remove any debugging statements that were added for development purposes.  2. **Review TODO/FIXME Comments**:    - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred    - Remove completed TODOs    - Convert remaining TODOs to proper issue tracking if needed  3. **Remove Debugging Code Blocks**:    - Remove temporary debugging code, test code blocks, and commented-out code    - Clean up any experimental code that's no longer needed    - Ensure proper error handling replaces temporary debug logging  **STEP 2: Documentation Review** Review and update documentation to reflect final implementation: 1. **Update Long-Term Memory Documents**: Based on what was actually implemented:    - If  exists: Update it if requirements changed during development    - If  exists: Update it if architectural impacts were identified    - If  exists: Update it if design details were refined or changed    - Otherwise: Document any changes in the plan file 2. **Compare Against Implementation**: Review documentation against actual implemented functionality 3. **Update Changed Sections**: Only modify documentation sections that have functional changes 4. **Remove Development Progress**: Remove references to development iterations, progress notes, and temporary decisions 5. **Focus on Final State**: Ensure documentation describes the final implemented state, not the development process 6. **Ask User to Review Document Updates** **STEP 3: Final Validation** - Run existing tests to ensure cleanup didn't break functionality - Verify documentation accuracy with a final review - Ensure code is ready for production/delivery Update task progress and mark completed work as you finalize the feature.","status":"open","priority":3,"issue_type":"task","owner":"github@beimir.net","created_at":"2026-03-20T11:16:23.028674+01:00","created_by":"Oliver Jägle","updated_at":"2026-03-20T11:16:23.028674+01:00","dependencies":[{"issue_id":"ade-9.4","depends_on_id":"ade-9","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"ade-9.4","depends_on_id":"ade-9.3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}

package/.beads/last-touched

@@ -1 +1 @@
-ade-8.5
+ade-11.3.15

package/.kiro/agents/ade.json

@@ -6,7 +6,12 @@
     "workflows": {
       "command": "npx",
       "args": ["@codemcp/workflows-server@latest"],
-      "autoApprove": ["*"]
+      "autoApprove": [
+        "whats_next",
+        "conduct_review",
+        "list_workflows",
+        "get_tool_info"
+      ]
     },
     "agentskills": {
       "command": "npx",
@@ -20,7 +25,10 @@
     "write",
     "shell",
     "spec",
-    "@workflows/*",
+    "@workflows/whats_next",
+    "@workflows/conduct_review",
+    "@workflows/list_workflows",
+    "@workflows/get_tool_info",
     "@agentskills/*"
   ],
   "useLegacyMcpJson": true

package/.kiro/settings/mcp.json

@@ -3,7 +3,12 @@
     "workflows": {
       "command": "npx",
       "args": ["@codemcp/workflows-server@latest"],
-      "autoApprove": ["*"]
+      "autoApprove": [
+        "whats_next",
+        "conduct_review",
+        "list_workflows",
+        "get_tool_info"
+      ]
     },
     "agentskills": {
       "command": "npx",

package/.opencode/agents/ade.md

@@ -2,6 +2,12 @@
 name: ade
 description: ADE — Agentic Development Environment agent with project conventions and tools
 permission:
+  "workflows*": "ask"
+  workflows_whats_next: "allow"
+  workflows_conduct_review: "allow"
+  workflows_list_workflows: "allow"
+  workflows_get_tool_info: "allow"
+  "agentskills*": "allow"
   read:
     "*": "allow"
     "*.env": "deny"
@@ -10,7 +16,7 @@ permission:
   skill: "deny"
   todoread: "deny"
   todowrite: "deny"
-  task: "deny"
+  task: "allow"
   lsp: "allow"
   glob: "allow"
   grep: "allow"
@@ -99,7 +105,6 @@ permission:
     "useradd *": "deny"
     "userdel *": "deny"
     "iptables *": "deny"
-  doom_loop: "deny"
 ---
 
 You are an AI assistant that helps users develop software features using the workflows server.

package/.vibe/beads-state-ade-extension-override-skills-d44z9p.json

@@ -0,0 +1,29 @@
+{
+  "conversationId": "ade-extension-override-skills-d44z9p",
+  "projectPath": "/Users/oliverjaegle/projects/privat/codemcp/ade",
+  "epicId": "ade-9",
+  "phaseTasks": [
+    {
+      "phaseId": "explore",
+      "phaseName": "Explore",
+      "taskId": "ade-9.1"
+    },
+    {
+      "phaseId": "plan",
+      "phaseName": "Plan",
+      "taskId": "ade-9.2"
+    },
+    {
+      "phaseId": "code",
+      "phaseName": "Code",
+      "taskId": "ade-9.3"
+    },
+    {
+      "phaseId": "commit",
+      "phaseName": "Commit",
+      "taskId": "ade-9.4"
+    }
+  ],
+  "createdAt": "2026-03-20T10:16:23.345Z",
+  "updatedAt": "2026-03-20T10:16:23.345Z"
+}

package/.vibe/beads-state-ade-fix-docset-writing-37fuoj.json

@@ -0,0 +1,29 @@
+{
+  "conversationId": "ade-fix-docset-writing-37fuoj",
+  "projectPath": "/Users/oliverjaegle/projects/privat/codemcp/ade",
+  "epicId": "ade-11",
+  "phaseTasks": [
+    {
+      "phaseId": "explore",
+      "phaseName": "Explore",
+      "taskId": "ade-11.1"
+    },
+    {
+      "phaseId": "plan",
+      "phaseName": "Plan",
+      "taskId": "ade-11.2"
+    },
+    {
+      "phaseId": "code",
+      "phaseName": "Code",
+      "taskId": "ade-11.3"
+    },
+    {
+      "phaseId": "commit",
+      "phaseName": "Commit",
+      "taskId": "ade-11.4"
+    }
+  ],
+  "createdAt": "2026-03-20T14:24:53.678Z",
+  "updatedAt": "2026-03-20T14:24:53.678Z"
+}

package/.vibe/development-plan-extension-override-skills.md

@@ -0,0 +1,110 @@
+# Development Plan: ade (extension-override-skills branch)
+
+*Generated on 2026-03-20 by Vibe Feature MCP*
+*Workflow: [epcc](https://mrsimpson.github.io/responsible-vibe-mcp/workflows/epcc)*
+
+## Goal
+Allow extension-contributed skills to declare that they replace/supersede generic baseline skills registered by the process option (`codemcp-workflows-skilled`). The resolver should deduplicate the final skills list so that only the effective (non-replaced) skills are shown and installed.
+
+## Explore
+<!-- beads-phase-id: ade-9.1 -->
+### Tasks
+- [x] Understand current skill registration flow (process → recipe → skills writer → LogicalConfig)
+- [x] Identify the exact duplication: `codemcp-workflows-skilled` registers 5 generic skills; architecture extensions like `sabdx-frontend` register domain-specific replacements with different names
+- [x] Evaluate solution options (replaces field, baseline priority, excludes at option level)
+- [x] Agree on preferred approach: `replaces?: string[]` on `SkillDefinition`
+
+### Phase Entrance Criteria:
+*(initial phase — no prior phase)*
+
+## Plan
+<!-- beads-phase-id: ade-9.2 -->
+### Tasks
+
+*Tasks managed via `bd` CLI*
+
+### Phase Entrance Criteria:
+- [ ] The problem is clearly understood: duplicate generic + domain-specific skills shown at setup
+- [ ] At least two solution alternatives have been evaluated
+- [ ] The preferred approach (`replaces` field on `SkillDefinition`) is agreed upon
+- [ ] Scope is clear: which files are touched
+
+## Code
+<!-- beads-phase-id: ade-9.3 -->
+### Tasks
+
+*Tasks managed via `bd` CLI*
+
+### Phase Entrance Criteria:
+- [ ] Concrete implementation plan is documented (what changes in which file)
+- [ ] Edge cases are identified (ordering, name-collision, TUI display)
+- [ ] Test strategy is defined
+
+## Commit
+<!-- beads-phase-id: ade-9.4 -->
+### Tasks
+- [ ] Squash WIP commits: `git reset --soft <first commit of this branch>`. Then, create a conventional commit. In the message, first summarize the intentions and key decisions from the development plan. Then, add a brief summary of the key changes and their side effects and dependencies.
+
+*Tasks managed via `bd` CLI*
+
+### Phase Entrance Criteria:
+- [ ] All implementation tasks are done and tests pass
+- [ ] The `replaces` field works end-to-end (resolver deduplicates, TUI shows reduced list)
+- [ ] No regressions in existing resolver tests
+
+## Key Decisions
+
+### KD-1: Add `replaces?: string[]` to `SkillDefinition`
+Both `InlineSkill` and `ExternalSkill` get an optional `replaces` field. Extension authors list the generic skill names they supersede. Deduplication happens as a post-processing step in the resolver (`resolve()` in `resolver.ts`).
+
+### KD-2: Deduplication strategy — last-writer-wins + replaces set
+After all provisions are merged, the resolver:
+1. Builds a Set of all names that appear in any skill's `replaces` array.
+2. Deduplicates by name (last occurrence wins, preserving insertion order otherwise) using a Map.
+3. Filters out any skill whose `name` is in the replaced-names Set.
+
+This means: if `sabdx-architecture` declares `replaces: ["architecture"]`, the generic `architecture` skill is dropped. The final list contains `sabdx-architecture` only.
+
+### KD-3: Skill file names on disk — unchanged
+Skills are written to `.ade/skills/<name>/SKILL.md` by `writeInlineSkills()` in `util.ts`.
+- The generic `architecture` skill → `.ade/skills/architecture/SKILL.md`
+- The replacing `sabdx-architecture` skill → `.ade/skills/sabdx-architecture/SKILL.md`
+
+Because `architecture` is filtered out **before** `writeInlineSkills()` is called, **no file is written for `architecture`**. Only `sabdx-architecture/SKILL.md` ends up on disk. The `replaces` field is a resolver-level concern; it does not need to be written to SKILL.md frontmatter.
+
+### KD-4: `replaces` field is stripped before writing SKILL.md
+`writeInlineSkills()` uses the skill's `name`, `description`, and `body` for the SKILL.md frontmatter. The `replaces` field is simply ignored during file writing — no changes needed in `util.ts`.
+
+### KD-5: `replaces` field is NOT persisted in `config.lock.yaml`
+The lock file records `logical_config`, which is the *post-dedup* skills list. Replaced skills never appear in the lock file.
+
+### KD-6: Ordering — extensions should register skills after process
+The resolver processes facets in `sortFacets()` order. The `architecture` facet comes after `process`, so extension skills are appended after the generic ones. The last-writer-wins Map dedup naturally lets extension skills win. But `replaces` is independent of ordering — it is an explicit declaration.
+
+## Notes
+
+### Full flow for the sadb-frontend scenario
+1. `codemcp-workflows-skilled` recipe runs → appends to `result.skills`: `[starting-project, architecture, application-design, coding, testing]`
+2. `sabdx-frontend` recipe runs → appends: `[sabdx-tasks, sabdx-starting-project{replaces:["starting-project"]}, sabdx-architecture{replaces:["architecture"]}, sabdx-application-design{replaces:["application-design"]}, sabdx-coding{replaces:["coding"]}, sabdx-testing{replaces:["testing"]}, tdd]`
+3. `conventional-commits` recipe runs → appends: `[conventional-commits]`
+4. Raw merged list: 13 skills
+5. Post-dedup (name Map + replaces filter): 8 skills remain — `[sabdx-tasks, sabdx-starting-project, sabdx-architecture, sabdx-application-design, sabdx-coding, sabdx-testing, tdd, conventional-commits]`
+6. `writeInlineSkills()` writes SKILL.md files for the 6 inline sabdx-* skills under `.ade/skills/<name>/`
+7. `installSkills()` installs all 8 into `.agentskills/skills/`
+
+### What files exist on disk after setup
+- `.ade/skills/sabdx-tasks/SKILL.md`
+- `.ade/skills/sabdx-starting-project/SKILL.md`
+- `.ade/skills/sabdx-architecture/SKILL.md`
+- `.ade/skills/sabdx-application-design/SKILL.md`
+- `.ade/skills/sabdx-coding/SKILL.md`
+- `.ade/skills/sabdx-testing/SKILL.md`
+- NO `.ade/skills/architecture/SKILL.md` (replaced, never written)
+- NO `.ade/skills/starting-project/SKILL.md` (replaced, never written)
+- etc.
+
+### The `tdd` skill from the extension — no `replaces` needed
+`tdd` is an external skill (`source: "mrsimpson/skills-coding"`) and there is no generic `tdd` skill in `codemcp-workflows-skilled`. No clash.
+
+---
+*This plan is maintained by the LLM and uses beads CLI for task management. Tool responses provide guidance on which bd commands to use for task management.*

package/.vibe/development-plan-fix-docset-writing.md

@@ -0,0 +1,77 @@
+# Development Plan: ade (fix-docset-writing branch)
+
+*Generated on 2026-03-20 by Vibe Feature MCP*
+*Workflow: [epcc](https://mrsimpson.github.io/responsible-vibe-mcp/workflows/epcc)*
+
+## Goal
+
+Refactor: collapse `option.docsets[]` into a `docset` provision writer in the recipe.
+
+**Background:** Currently `Option` has two separate mechanisms for contributing to `knowledge_sources`:
+1. `recipe[]` entries with provision writers (skills, git-hooks, instruction, etc.)
+2. A separate `docsets?: DocsetDef[]` sibling field — with its own confirmation UI, per-item exclusion (`excluded_docsets`), and `collectDocsets()` helper
+
+The `docsets` field was kept separate to support per-docset user confirmation/exclusion. But this is inconsistent with how skills work — skills are presented as a bulk "install N skills?" prompt, not a per-skill multiselect. Docsets should follow the same pattern: a `docset` provision writer in the recipe that contributes to `knowledge_sources`, with a bulk defer prompt (matching skills), and no per-item exclusion UI.
+
+**Target design:**
+- `Option.docsets?: DocsetDef[]` → removed
+- new `docset` provision writer → pushes a `KnowledgeSource` to `knowledge_sources[]`
+- confirmation/exclusion multiselect in `setup.ts` → removed
+- `excluded_docsets` in `UserConfig` → removed
+- `collectDocsets()` → removed
+
+## Explore
+<!-- beads-phase-id: ade-11.1 -->
+### Tasks
+
+*Tasks managed via `bd` CLI*
+
+## Plan
+<!-- beads-phase-id: ade-11.2 -->
+
+### Phase Entrance Criteria
+- [ ] All usages of `docsets`, `collectDocsets`, `excluded_docsets` are catalogued
+- [ ] Scope and approach are clearly understood
+
+### Tasks
+
+*Tasks managed via `bd` CLI*
+
+## Code
+<!-- beads-phase-id: ade-11.3 -->
+
+### Phase Entrance Criteria
+- [ ] Plan is complete and agreed
+- [ ] New `docset` writer shape is defined
+- [ ] All affected files are identified
+
+### Tasks
+
+*Tasks managed via `bd` CLI*
+
+## Commit
+<!-- beads-phase-id: ade-11.4 -->
+
+### Phase Entrance Criteria
+- [ ] All tests pass
+- [ ] No references to `docsets`, `collectDocsets`, or `excluded_docsets` remain in production code
+
+### Tasks
+- [ ] Squash WIP commits: `git reset --soft <first commit of this branch>`. Then, create a conventional commit. In the message, first summarize the intentions and key decisions from the development plan. Then, add a brief summary of the key changes and their side effects and dependencies.
+
+*Tasks managed via `bd` CLI*
+
+## Key Decisions
+
+- `docsets` as a sibling field on `Option` exists solely to support per-item confirmation/exclusion — a UI concern, not a data model concern
+- Skills set the right precedent: bulk defer prompt, no per-item opt-out
+- The `docset` provision writer config shape should match `DocsetDef`: `{ id, label, origin, description }`
+- Mapping: writer config `id` → `KnowledgeSource.name`, `description` → `KnowledgeSource.description`, `origin` → `KnowledgeSource.origin`
+
+## Notes
+
+- Previous WIP commit on `fix-docset-writing`: removed `knowledge` writer, wired `installKnowledge` into setup/install
+- The `knowledge.ts` writer file still exists on disk (dead code) — can be deleted as part of this refactor
+
+---
+*This plan is maintained by the LLM and uses beads CLI for task management. Tool responses provide guidance on which bd commands to use for task management.*