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

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	priority	ordinal
TASK-10	Build the local skills registry	Done		2026-06-03 19:13	2026-06-05 07:28	mvp agent skills	TASK-2	PRD.md	high	10000

Description

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.

Acceptance Criteria

• #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

Implementation Plan

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.

Implementation Notes

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.

Final Summary

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.