aoa-bounded-context-map

Intent

Use bounded-context thinking to reduce semantic drift, mixed responsibilities, and unclear interfaces.

Trigger boundary

Use this skill when:

• a project mixes several domains or subsystems
• naming is drifting or overloaded
• the task needs a clearer boundary before coding safely
• an agent is likely to confuse nearby concepts without sharper separation

Do not use this skill when:

• the change is tiny and fully local
• the boundary is already clear and agreed on, and the real task is validating the interface contract; use aoa-contract-test
• the main problem is deciding whether logic belongs in the core or at the edge; use aoa-core-logic-boundary first

Inputs

• target area or subsystem
• current naming and responsibilities
• known neighboring contexts
• ambiguous or overloaded terms

Outputs

• named contexts or subsystems
• rough boundary map
• interface notes between contexts
• ambiguity notes and recommended vocabulary

Procedure

1. identify the target area and the terms people use for it
2. separate responsibilities into bounded contexts or subsystems
3. name what belongs inside each context and what stays outside
4. describe the interfaces or translations between contexts
5. note ambiguous terms and propose clearer language
6. report how the new boundary should shape future changes

Contracts

• boundaries should reduce semantic confusion, not create ceremony for its own sake
• neighboring contexts should be named explicitly when relevant
• interface or translation points should be visible

Risks and anti-patterns

• inventing too many contexts for a small problem
• renaming concepts without reducing confusion
• treating context maps as proof of good architecture when interfaces remain muddy

Verification

• confirm the main ambiguity was reduced
• confirm interfaces or handoff points are named
• confirm the output helps future scoped changes

Technique traceability

Manifest-backed techniques:

• AOA-T-0016 from 8Dionysus/aoa-techniques at 5c6f0496edc3c2e74590baa35627c85fe58ef765 using path techniques/docs/bounded-context-map/TECHNIQUE.md and sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Risks, Validation
• AOA-T-0002 from 8Dionysus/aoa-techniques at 5c6f0496edc3c2e74590baa35627c85fe58ef765 using path techniques/docs/source-of-truth-layout/TECHNIQUE.md and sections: summary

Adaptation points

Project overlays should add:

• local domain vocabulary
• canonical docs that define terminology
• local examples of context boundaries