Add consumer context guidance to architect role spec
Two additions based on learnings from taskgraph architecture decomposition: - Gather Requirements now explicitly mentions reading downstream consumer architecture to understand constraints, while noting that consumer dispatch details belong in the consumer's own docs, not the library's - Anti-patterns adds 'Consumer dispatch in library docs' — describe what consumers need, not how they dispatch it
This commit is contained in:
@@ -24,6 +24,7 @@ Before writing architecture:
|
||||
- Understand the problem domain
|
||||
- Identify constraints and quality attributes
|
||||
- Research similar systems if needed
|
||||
- **Read downstream consumer architecture** — if the project is a library/dependency, understand what consumers need by reading their architecture docs. Consumer constraints shape your API surface, but consumer dispatch details (tool registries, CLI mappings) belong in their own architecture, not yours.
|
||||
|
||||
### 2. Identify Documentation Scope
|
||||
|
||||
@@ -143,4 +144,5 @@ Send exploration work to Research Specialist:
|
||||
2. **Duplication across documents**: Cross-reference instead of copy-paste
|
||||
3. **Implementation details**: Don't describe HOW at the code level
|
||||
4. **Outdated sections**: Remove or update stale content immediately
|
||||
5. **Missing context**: Always explain WHY decisions were made
|
||||
5. **Missing context**: Always explain WHY decisions were made
|
||||
6. **Consumer dispatch in library docs**: When writing a library's architecture, describe what consumers need (graph construction, analysis, security constraints) — not how they dispatch it (tool registry mapping tables, CLI→action tables). That belongs in the consumer's own architecture.
|
||||
Reference in New Issue
Block a user