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
|
- Understand the problem domain
|
||||||
- Identify constraints and quality attributes
|
- Identify constraints and quality attributes
|
||||||
- Research similar systems if needed
|
- 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
|
### 2. Identify Documentation Scope
|
||||||
|
|
||||||
@@ -144,3 +145,4 @@ Send exploration work to Research Specialist:
|
|||||||
3. **Implementation details**: Don't describe HOW at the code level
|
3. **Implementation details**: Don't describe HOW at the code level
|
||||||
4. **Outdated sections**: Remove or update stale content immediately
|
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