Product and architecture documentation for the Agyn AI agent orchestrator platform.
The desired state of the product. Declarative descriptions of capabilities, behaviors, and user experiences. No references to current implementation state, no transitional statements, no legacy caveats. When the product changes, this directory is updated to reflect the new target — not annotated with "currently X, will become Y."
The desired state of the system. Declarative descriptions of all services, patterns, protocols, and contracts. No references to current implementation state, no transitional statements, no legacy caveats. When the architecture changes, this directory is updated to reflect the new target — not annotated with "currently X, will become Y."
Gaps between the desired state described in /product or /architecture and current reality. Each file represents a single delta. When reality matches the desired state, the file is deleted. Git history preserves the full record.
Topics that require further investigation and a decision. Specifications for areas with unresolved questions should be avoided. Raise an open question or wait for a decision instead of specifying behavior that may change.
Product — Desired Product State
Target product definition. Describes how the product should work from the user's perspective. See Product README for the full list of product docs.
Architecture — Desired Architecture State
Target architecture of the platform. Describes how the system should work. See Architecture README for the full list of architecture docs.
Maps — Cross-links
Navigation between product and architecture docs.
| Document | Description |
|---|---|
| Product to Architecture Map | Cross-links between product specs and architecture docs |
Operations — CI/CD, Local Development, Configuration
How services are built, deployed, run locally, and configured. See Architecture README for the full list.
Changes — Pending Deltas
Gaps between desired state and current reality. See Changes README for lifecycle rules.
Unresolved product and architectural decisions requiring discussion.