ReddRadar
Agent skill
initialize-architecture
Use to create complete architecture documentation structure. Creates all required architecture documents from templates.
Install this agent skill to your Project
npx add-skill https://github.com/resolve-io/.prism/tree/main/plugins/prism-devtools/skills/initialize-architecture
SKILL.md
Initialize Architecture Documentation Task
When to Use
- New Projects: Initialize architecture documentation for greenfield projects
- Missing Documentation: Create missing architecture documents in existing projects
- Architecture Reset: Rebuild architecture documentation structure
- Onboarding: Ensure all architecture documents exist for new team members
What This Skill Does
Creates complete architecture documentation structure from templates:
- Configuration: Reads locations from
.prism/core-config.yaml - Status Check: Detects existing vs missing documents
- Generation: Creates documents from standardized templates
- Indexing: Builds master README with navigation
Prerequisites
- Project root must have
.prism/core-config.yaml architecture.architectureShardedLocationconfig (default:docs/architecture)- Write permissions to create files
Quick Start
- Run the skill
- Review existing documentation status
- Choose mode (create missing or recreate all)
- Wait for document generation
- Review generated documents and fill in project-specific details
Output Location: docs/architecture/ (or as configured)
Workflow Steps
| Step | Name | Purpose |
|---|---|---|
| 1 | Load Configuration | Read core-config.yaml settings |
| 2 | Check Existing | Show status of existing docs |
| 3 | Create Directory | Ensure architecture folder exists |
| 4 | Generate Documents | Create documents from templates |
| 5 | Create Master Index | Build README.md navigation |
| 6 | Validate & Complete | Verify files and show next steps |
Documents Generated
| Document | Purpose |
|---|---|
coding-standards.md |
Code quality and style guidelines |
tech-stack.md |
Technologies, frameworks, dependencies |
source-tree.md |
Code organization and structure |
deployment.md |
Infrastructure and deployment process |
data-model.md |
Database schemas and relationships |
api-contracts.md |
API endpoints and integrations |
README.md |
Master index and navigation |
Modes
- Create Missing: Only generate documents that don't exist
- Recreate All: Regenerate all documents (overwrites existing)
- Cancel: Exit without changes
Reference Documentation
- Document Templates - Detailed templates for each document type
Document Status Indicators
All documents start as Draft and progress through:
- 🔴 Draft - Initial template, needs content
- 🟡 In Progress - Being actively updated
- 🟢 Complete - Reviewed and approved
Next Steps After Initialization
- 📝 Review each document and fill in project-specific details
- 🎨 Update status indicators as documents are completed
- 👥 Assign document owners
- 📅 Schedule quarterly reviews
- 🔄 Keep documentation current with architecture changes
Guardrails
- Always verify config is loaded before proceeding
- Check for existing documents to avoid accidental overwrites
- Write files immediately after generation
- Inform user of all files created
- Provide clear next steps for document completion
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
resolve-io/.prism
review-story
Use to perform comprehensive test architecture review with quality gate decision. Creates both story updates and detailed gate files.
resolve-io/.prism
create-dev-task
Use to generate development task documents for the Dev agent. Creates specifications describing WHAT needs fixing based on validated issues and investigations.
resolve-io/.prism
test-design
Use to design test strategies and create test specifications. Documents testing approaches for stories.
resolve-io/.prism
sdlc-handoff
Use for SDLC phase transitions. Ensures proper handoff between development phases with documentation.
resolve-io/.prism
qa-gate
Use to create or update quality gate decision files for stories. Provides clear pass/fail decisions with actionable feedback.
resolve-io/.prism
document-project
Use to analyze and document any project codebase. Creates comprehensive reference documentation for AI-assisted development including architecture and patterns.
Didn't find tool you were looking for?