project-planning
Generate project planning documents
Starting a new project without clear planning leads to architectural drift and context loss. This skill generates four essential documents (PVS, ADR, Tech Spec, Roadmap) that guide AI-assisted development and maintain coherence across coding sessions.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "project-planning". Generate planning documents for a personal fragrance rating app
Resultado esperado:
- Created 4 planning documents in docs/planning/:
- - project-vision.md (problem statement and scope)
- - tech-spec.md (Python/FastAPI/SQLite stack specification)
- - roadmap.md (4-phase implementation plan)
- - adr/adr-001-monolith-choice.md (architecture decision)
- Next steps:
- 1. Review each document for accuracy
- 2. Run: /plan synthesize to create PROJECT-PLAN.md
- 3. Start Phase 0: /git/milestone start feat/phase-0-foundation
A utilizar "project-planning". Create an ADR for our database choice
Resultado esperado:
- Created docs/planning/adr/adr-002-database-choice.md with:
- - Context: Current data requirements and constraints
- - Decision: PostgreSQL with SQLAlchemy ORM
- - Alternatives considered: SQLite, MongoDB, MySQL
- - Consequences: Migrations, hosting requirements, scaling path
A utilizar "project-planning". Update roadmap after completing Phase 1
Resultado esperado:
- Updated docs/planning/roadmap.md:
- - Marked all Phase 1 tasks as complete
- - Added completion percentage to Phase 1 milestone
- - Moved Phase 2 tasks to TODO list
- - Updated timeline based on actual velocity
Auditoria de Segurança
SeguroAll 214 static findings are FALSE POSITIVES. The analyzer misinterprets markdown backtick syntax as Ruby/shell command execution, documentation references to algorithms as cryptographic usage, and file path patterns as path traversal. This is a pure documentation skill containing only markdown files and one benign Python validation script that reads files without network calls, file writes, or command execution.
Fatores de risco
⚙️ Comandos externos (171)
🌐 Acesso à rede (1)
📁 Acesso ao sistema de arquivos (4)
Pontuação de qualidade
O Que Você Pode Construir
Start new AI-assisted projects
Generate comprehensive planning documents before writing any code to ensure AI tools have clear architectural context.
Document architectural decisions
Create ADRs that capture key technical choices with rationale, alternatives considered, and consequences.
Plan phased implementation
Build detailed roadmaps with user stories, success criteria, and clear phase dependencies.
Tente Estes Prompts
I want to build a [project type] for [target users] that solves [problem]. Use the /plan skill to generate project planning documents with the following constraints: [list constraints].
Review the planning documents in docs/planning/ against the current codebase. Check for consistency between what was planned and what was implemented. Flag any discrepancies.
I completed [task] from Phase [N]. Update docs/planning/roadmap.md to mark tasks as complete, update milestone progress, and add the next tasks to the TODO list.
I need to make a technical decision about [component/feature]. Create an ADR in docs/planning/adr/adr-[NNN]-[topic].md that documents the context, options considered, decision made, and consequences.
Melhores Práticas
- Generate planning documents before writing any code to establish architectural context for AI assistants
- Review and validate each document using the consensus tool before proceeding to the next document
- Update documents as the project evolves to prevent drift between planned and actual implementation
Evitar
- Skipping planning and asking AI to generate code without architectural context
- Using generated documents without reviewing them for project-specific accuracy
- Failing to update documents when implementation differs from the original plan
Perguntas Frequentes
Does this skill modify my project files?
Can I use this with existing projects?
What tools does this skill require?
How many documents are generated?
Is my project data safe?
How is this different from other planning tools?
Detalhes do Desenvolvedor
Autor
ByronWilliamsCPALicença
MIT
Repositório
https://github.com/ByronWilliamsCPA/fragrance-rater/tree/main/.claude/skills/project-planningReferência
main
Estrutura de arquivos