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:
2026-04-26 06:39:38 +00:00
parent bde1cc4e70
commit 235328813e

View File

@@ -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.