architecture

Par anthropics · knowledge-work-plugins

Créer ou évaluer un enregistrement de décision d'architecture (ADR). À utiliser lors du choix entre des technologies (par ex., Kafka vs SQS), pour documenter une décision de conception avec ses compromis et ses conséquences, pour examiner une proposition de conception système, ou pour concevoir un nouveau composant à partir d'exigences et de contraintes.

npx skills add https://github.com/anthropics/knowledge-work-plugins --skill architecture

/architecture

Si vous voyez des placeholders non familiers ou si vous devez vérifier quels outils sont connectés, consultez CONNECTORS.md.

Créez un Architecture Decision Record (ADR) ou évaluez une conception système.

Usage

/architecture $ARGUMENTS

Modes

Créer un ADR : « Devrions-nous utiliser Kafka ou SQS pour notre event bus ? » Évaluer une conception : « Passez en revue cette proposition de microservices » Conception système : « Concevez le système de notifications pour notre application »

Consultez la skill system-design pour des frameworks détaillés sur la collecte des exigences, l'analyse de scalabilité et l'évaluation des compromis.

Output — Format ADR

# ADR-[number]: [Title]

**Status:** Proposed | Accepted | Deprecated | Superseded
**Date:** [Date]
**Deciders:** [Who needs to sign off]

## Context
[What is the situation? What forces are at play?]

## Decision
[What is the change we're proposing?]

## Options Considered

### Option A: [Name]
| Dimension | Assessment |
|-----------|------------|
| Complexity | [Low/Med/High] |
| Cost | [Assessment] |
| Scalability | [Assessment] |
| Team familiarity | [Assessment] |

**Pros:** [List]
**Cons:** [List]

### Option B: [Name]
[Same format]

## Trade-off Analysis
[Key trade-offs between options with clear reasoning]

## Consequences
- [What becomes easier]
- [What becomes harder]
- [What we'll need to revisit]

## Action Items
1. [ ] [Implementation step]
2. [ ] [Follow-up]

Si les Connectors sont disponibles

Si la base de connaissances est connectée :

  • Recherchez les ADR et documents de conception antérieurs
  • Trouvez le contexte technique pertinent

Si le project tracker est connecté :

  • Liez aux épics et tickets associés
  • Créez des tâches d'implémentation

Conseils

  1. Énoncez les contraintes d'emblée — « Nous devons livrer en 2 semaines » ou « Doit supporter 10K rps » oriente la réponse.
  2. Nommez vos options — Même si vous penchez d'un côté, je fournirai une analyse plus équilibrée avec des alternatives explicites.
  3. Incluez les exigences non-fonctionnelles — La latence, le coût, l'expertise de l'équipe et la charge de maintenance comptent autant que les fonctionnalités.

Skills similaires