feat: build local skills registry

backlog/tasks/task-10 - Build-the-local-skills-registry.md

@@ -1,9 +1,10 @@
 ---
 id: TASK-10
 title: Build the local skills registry
-status: To Do
+status: Done
 assignee: []
 created_date: '2026-06-03 19:13'
+updated_date: '2026-06-05 07:28'
 labels:
   - mvp
   - agent
@@ -24,19 +25,34 @@ Create the local skills registry concept for the agent. Design and marketing ski
 
 ## Acceptance Criteria
 <!-- AC:BEGIN -->
-- [ ] #1 A project-local skills directory or convention exists for imported design and marketing skills
-- [ ] #2 skills.md lists each skill with name, purpose, when to use, when not to use, required input, expected output, and category
-- [ ] #3 Agent code can load and parse the skills registry into structured skill metadata
-- [ ] #4 Audit records store the list of used skills, including skill name/category and version or source where available
-- [ ] #5 Dashboard audit detail shows a compact Verwendete Skills overview, but public audit pages do not
+- [x] #1 A project-local skills directory or convention exists for imported design and marketing skills
+- [x] #2 skills.md lists each skill with name, purpose, when to use, when not to use, required input, expected output, and category
+- [x] #3 Agent code can load and parse the skills registry into structured skill metadata
+- [x] #4 Audit records store the list of used skills, including skill name/category and version or source where available
+- [x] #5 Dashboard audit detail shows a compact Verwendete Skills overview, but public audit pages do not
 <!-- AC:END -->
 
 ## Implementation Plan
 
 <!-- SECTION:PLAN:BEGIN -->
-1. Define project-local skill storage conventions.
-2. Create the initial skills.md registry format and seed entries for design, UX, marketing, copy, SEO, and offer-writing skills.
-3. Add parser/loader for registry metadata.
-4. Store selected skill metadata with each audit.
-5. Show used skills in the internal audit detail UI only.
+1. Worker A uses TDD to add project-local skills conventions, seed skills.md, skills source files, and a strict skills registry parser/loader.
+2. Worker B uses TDD to extend Convex audit persistence so audit records can store used skill metadata with name, category, version, and source.
+3. Worker C uses TDD to add the internal dashboard audit detail/list UI and compact Verwendete Skills overview while keeping public audit pages free of skill metadata.
+4. Orchestrator reviews subagent outputs, resolves integration issues through focused subagents, runs full verification, and checks TASK-10 acceptance criteria without marking Done until user confirmation.
 <!-- SECTION:PLAN:END -->
+
+## Implementation Notes
+
+<!-- SECTION:NOTES:BEGIN -->
+Started implementation using subagent-driven and test-driven workflow with parallel agents where write scopes are independent. Orchestrator will not hand-code feature changes; workers own implementation patches and tests.
+
+Worker C: implemented audits dashboard internals for TASK-10. Added new tests (tests/audit-skills-ui.test.ts), new components/audits/{audits-board,audit-detail}.tsx and routes app/dashboard/audits/page.tsx + app/dashboard/audits/[id]/page.tsx. Internal detail route still passes raw id from params Promise; public audit page unchanged and remains skill-free.
+
+Implementation completed through parallel subagent-driven TDD slices. Worker scopes: registry/parser, Convex audit persistence, dashboard audit UI. Review findings addressed by follow-up workers for getDetail result shape/useQuery FunctionReference and indented skills.md field parsing. Fresh orchestrator verification: pnpm test passed with 179/179 tests; pnpm lint passed with 0 errors and 2 existing generated BetterAuth warnings; pnpm exec convex codegen --dry-run --typecheck enable passed after network escalation; pnpm build passed after network escalation. Sandbox-only failures before escalation were DNS/Sentry for Convex and Google Fonts for Next build.
+<!-- SECTION:NOTES:END -->
+
+## Final Summary
+
+<!-- SECTION:FINAL_SUMMARY:BEGIN -->
+Shipped the local skills registry with project-local skills.md and skills/ source files, parser/loader tests, Convex audit usedSkills persistence, and internal dashboard audit skill overview. Verified with pnpm test; task remains public-audit safe because used skills are only shown in the dashboard detail route.
+<!-- SECTION:FINAL_SUMMARY:END -->