59 lines
3.6 KiB
Markdown
59 lines
3.6 KiB
Markdown
---
|
|
id: TASK-10
|
|
title: Build the local skills registry
|
|
status: Done
|
|
assignee: []
|
|
created_date: '2026-06-03 19:13'
|
|
updated_date: '2026-06-05 07:28'
|
|
labels:
|
|
- mvp
|
|
- agent
|
|
- skills
|
|
dependencies:
|
|
- TASK-2
|
|
references:
|
|
- PRD.md
|
|
priority: high
|
|
ordinal: 10000
|
|
---
|
|
|
|
## Description
|
|
|
|
<!-- SECTION:DESCRIPTION:BEGIN -->
|
|
Create the local skills registry concept for the agent. Design and marketing skills are stored in the project repository and summarized in a skills.md registry so the agent can select relevant analysis and writing guidance for each audit while the dashboard shows which skills were used.
|
|
<!-- SECTION:DESCRIPTION:END -->
|
|
|
|
## Acceptance Criteria
|
|
<!-- AC:BEGIN -->
|
|
- [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. 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 -->
|