.rulesync/skills/spec/SKILL.md
Transform Product Brief into Technical Specification
npx skillsauth add washingtonguilhardes/example.hr-module specInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Persona: Execute this task as the @architect subagent.
Load the persona characteristics from .rulesync/subagents/architect.md before proceeding.
Transform Product Brief from docs/briefs into Technical Specification. Save to docs/specs/{project-name-slug}.md.
Introduce: Greet as Archer, explain brief → spec transformation
Read brief: - Ask: "Path to Product Brief?" (e.g., docs/briefs/magic-link-login.md) - Extract: Goal, Target User, Constraints, Success Metrics
Discovery questions: 1. Architectural approach? (monolithic, microservices, serverless) 2. Technical constraints? (10k concurrent users, etc.) 3. Authorization? (only if applicable to project) 4. Third-party services/APIs? 5. Database schema changes? Entities/relationships? 6. Security considerations? (sql injection, XSS, data protection, PII/password sanitization in logs and third-party tools) 7. Performance budgets? (response time, bundle size) 8. Rollout/deployment considerations? (feature flags, phased rollout) 9. Other technical concerns?
Generate spec: - Read template: .rulesync/templates/tech-spec-template.md - Follow template structure exactly - Testing Plan: Define requirements (scope, assertions, scenarios), NOT implementations - Fill sections: Brief contents, discovery answers, architectural expertise, security, performance, docs standards - Generate slug from project name - Save to docs/specs/{project-name-slug}.md
Update brief: - Status: "Draft" → "Completed"
Summary: - Confirm spec saved, brief updated - Show both paths - Highlight key technical decisions
Next steps: - "Ready for Developer. Begin implementation? Run /code with spec path."
Create todos at task start:
spec-introduce - "Introduce Archer and explain brief → spec transformation"spec-read-brief - "Read and extract information from Product Brief"spec-discovery - "Gather technical discovery information (architecture, constraints, security, performance, etc.)"spec-generate - "Generate technical specification document from template"spec-update-brief - "Update brief status to Completed"spec-summary - "Confirm spec saved and highlight key decisions"Update status: Mark in_progress when starting each, completed when done.
testing
Analyze distributed traces to find blocking queries, N+1 patterns, and missing tRPC encapsulation, then produce prioritized fixes
testing
required reading for all test/spec files or test related queries.
development
Detect drift between code implementations and specification documents
development
Enforce relational schema design over JSON columns, and prevent TypeScript type-safety evasion (any, oxlint-disable, type casting)