docs: integrate Gur Sannikov ADR workflow + native capabilities audit (4/5)
- Add ADR-Driven Development pattern to methodologies.md (~60 lines) - Pattern: ADR → skill → native execution - Example ADR template (database migration) - Complete bash workflow with benefits - Add Native Capabilities Audit checklist to architecture.md (~50 lines) - 11 native capabilities with internal links - Onboarding tip for comprehension audit - Add Dynamic Model Switching pattern to cheatsheet.md (~40 lines) - Pattern: Sonnet → Opus → Sonnet - Cost comparison table and best practices - Add Community Validation to architecture.md (~15 lines) - External validation of 'less scaffolding, more model' approach - Cursor power user adopting Agent Skills standard - Track evaluation in docs/resource-evaluations/ (full methodology) - Update evaluations count: 24 → 55 (README + reference.yaml) - Update CHANGELOG.md with integration details Source: https://www.linkedin.com/posts/gursannikov_claudecode-embeddedengineering-aiagents-activity-7423851983331328001-DrFb Score: 4/5 (HIGH VALUE) - fills ADR workflow gap + onboarding checklist Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
b48d95c024
commit
4c0e4b6ac6
7 changed files with 389 additions and 6 deletions
|
|
@ -272,6 +272,56 @@ Meta-Agent (Orchestrator)
|
|||
└── Reviewer (validation)
|
||||
```
|
||||
|
||||
### ADR-Driven Development
|
||||
|
||||
**Pattern**: Write plain English ADRs → Feed to implement-adr skill → Execute natively
|
||||
|
||||
Architecture Decision Records (ADRs) combined with Claude Code skills create a workflow where architectural decisions drive implementation directly.
|
||||
|
||||
**Workflow Steps**:
|
||||
1. **Document decision** in ADR format (context, decision, consequences)
|
||||
2. **Create implementation skill** (generic or `implement-adr` specialized)
|
||||
3. **Feed ADR as prompt** to skill with clear acceptance criteria
|
||||
4. **Claude executes** based on architectural guidance in ADR
|
||||
|
||||
**Example ADR Template**:
|
||||
```
|
||||
# ADR-001: Database Migration Strategy
|
||||
|
||||
## Context
|
||||
Legacy MySQL schema needs migration to PostgreSQL for better JSON support.
|
||||
|
||||
## Decision
|
||||
Use incremental dual-write pattern with feature flags.
|
||||
|
||||
## Consequences
|
||||
- Positive: Zero-downtime migration
|
||||
- Negative: Temporary code complexity during transition
|
||||
```
|
||||
|
||||
**Implementation Workflow**:
|
||||
```bash
|
||||
# 1. Write ADR (plain English)
|
||||
vim docs/adr/001-database-migration.md
|
||||
|
||||
# 2. Feed to implementation skill
|
||||
/implement-adr docs/adr/001-database-migration.md
|
||||
|
||||
# 3. Claude executes based on ADR guidance
|
||||
# → Creates migration scripts
|
||||
# → Updates ORM configuration
|
||||
# → Adds feature flags
|
||||
# → Implements dual-write logic
|
||||
```
|
||||
|
||||
**Benefits**:
|
||||
- ✅ **Documentation-driven**: Architecture and code stay synchronized
|
||||
- ✅ **Native execution**: No external frameworks needed
|
||||
- ✅ **Traceable decisions**: Clear audit trail from decision to implementation
|
||||
- ✅ **Team alignment**: ADRs communicate intent to both humans and AI
|
||||
|
||||
**Source**: [Gur Sannikov embedded engineering workflow](https://www.linkedin.com/posts/gursannikov_claudecode-embeddedengineering-aiagents-activity-7423851983331328001-DrFb)
|
||||
|
||||
---
|
||||
|
||||
### Tier 6: Optimization
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue