Refine Skill
Use this skill for periodic workflow maintenance and architecture hygiene.
Team-awareness
Read active team config from .codex-workflow/config/active-team.json when present.
Use the team defaults to scope refinements to relevant issue and architecture locations.
Modes
Full refinement (default)
- •Review pattern health:
- •most-used patterns
- •stale patterns
- •conflicting patterns
- •Review promotion candidates:
- •high usage
- •stable usage
- •cross-feature applicability
- •Identify coverage gaps by work type.
- •Produce action list:
- •promote
- •archive
- •create missing pattern
Promote specific pattern
- •Convert pattern into ADR draft sections:
- •context
- •decision
- •consequences
- •Create ADR draft in architecture decisions.
- •Mark pattern as promoted and link ADR.
Archive specific pattern
- •Move pattern to archived folder.
- •Update pattern indexes/logs.
- •Record archive reason.
Output expectations
- •Concise refinement report with explicit actions and affected files.
- •No heavy prose; focus on decision support.