| name | openup-elaboration |
| description | Initialize and manage Elaboration phase activities - establish architecture baseline |
| model | haiku |
| arguments | [{"name":"activity","description":"Specific activity to perform (initiate, check-status, next-steps)","required":false}] |
Elaboration Phase
This skill guides you through the Elaboration phase of OpenUP - establishing the architecture baseline.
Thin front over the process map (T-077). This phase's activity
composition is data, not prose: run
python3 scripts/openup-process-map.py activities-for elaboration for the
authoritative ordered activities (each resolved to its role + skills), and let
/openup-start-iteration Plan Iteration generate this phase's work-item
lanes from that map. The guidance below is human-facing reference — the map +
Plan Iteration are the source of truth for what an Elaboration iteration runs.
When to Use
Use this skill when:
- Inception is complete and need to establish architecture baseline
- Need to design and validate system architecture
- Resolving high-risk technical elements
- Implementing architectural prototypes
- Checking if Elaboration phase is complete
- Getting guidance on next steps in Elaboration
When NOT to Use
Do NOT use this skill when:
- Still defining project vision and scope (use
/openup-inception)
- Architecture is stable and ready for incremental build (move to Construction)
- Need to create specific artifacts (use artifact skills)
- Looking for iteration planning (use
/openup-create-iteration-plan)
Success Criteria
After using this skill, verify:
Elaboration Overview
Goal: Design and implement the architecture, resolve high-risk elements
Duration: Typically 4-8 weeks
Key Milestone: Lifecycle Architecture
Phase Objectives
- Design and validate the architecture
- Detail the critical use cases
- Implement and test the architectural baseline
- Refine the project plan with accurate estimates
- Mitigate high-priority risks
Completion Criteria
Process
1. Read Project Status
Read docs/project-status.md to:
- Confirm phase is
elaboration
- Check iteration goals
- Review active work items
2. Based on Activity
initiate: Start Elaboration phase
- Update
docs/project-status.md to set phase: elaboration
- Create
docs/architecture-notebook.md from template
- Review and refine
docs/risk-list.md for technical risks
- Update
docs/roadmap.md with elaboration tasks
check-status: Review progress
- Check all completion criteria above
- List what's done and what remains
- Identify blockers
next-steps: Get recommendations
- Suggest next tasks based on current state
- Prioritize by technical risk and dependencies
Key Work Products
- Architecture Notebook (
docs/architecture-notebook.md) - Architecture documentation
- Design (
docs/design/*.md) - Detailed design documents
- Use Cases (
docs/use-cases/*.md) - Detailed use cases
- Developer Tests - Test implementations
- Updated Project Plan (
docs/project-plan.md)
Recommended Team
For Elaboration phase work, create a team with:
- architect - Lead architecture design
- developer - Implement architectural baseline
- tester - Validate architecture through testing
- Add analyst for detailed requirements
References
- Elaboration Phase:
docs-eng-process/openup-knowledge-base/practice-management/risk_value_lifecycle/guidances/concepts/phase-elaboration.md
- Architect Role:
docs-eng-process/openup-knowledge-base/core/role/roles/architect-6.md
- Architecture Notebook Template:
docs-eng-process/templates/architecture-notebook.md
See Also