Skip to content

adr

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

adr

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ADR-0001-explicit-opt-in-cross-cutting-behavior.md
ADR-0001-explicit-opt-in-cross-cutting-behavior.md
 
 
ADR-0005-event-driven-internal-bus.md
ADR-0005-event-driven-internal-bus.md
 
 
ADR-0006-cross-cutting-decorators.md
ADR-0006-cross-cutting-decorators.md
 
 
ADR-0007-unified-client-service-contract.md
ADR-0007-unified-client-service-contract.md
 
 
ADR-0007-unified-service-ui-contract.md
ADR-0007-unified-service-ui-contract.md
 
 
ADR-0008-free-first-modular-platform.md
ADR-0008-free-first-modular-platform.md
 
 
ADR-0009-core-architecture-principles.md
ADR-0009-core-architecture-principles.md
 
 
ADR-0010-rest-service-boundaries.md
ADR-0010-rest-service-boundaries.md
 
 
ADR-0011-stored-procedure-database-access.md
ADR-0011-stored-procedure-database-access.md
 
 
ADR-0015-dynamic-service-discovery-ai-models.md
ADR-0015-dynamic-service-discovery-ai-models.md
 
 
ADR-0016-configuration-as-source-of-truth.md
ADR-0016-configuration-as-source-of-truth.md
 
 
ADR-0022-reproducible-build-artifacts-and-distribution.md
ADR-0022-reproducible-build-artifacts-and-distribution.md
 
 
ADR-0023-canonical-flossware-ai-state-root.md
ADR-0023-canonical-flossware-ai-state-root.md
 
 
ADR-0024-contract-centric-repository-layering-and-naming.md
ADR-0024-contract-centric-repository-layering-and-naming.md
 
 
ADR-0025-ai-architecture-ownership.md
ADR-0025-ai-architecture-ownership.md
 
 
ADR-0026-two-component-release-versioning.md
ADR-0026-two-component-release-versioning.md
 
 
ADR-0027-versioning-tagging-and-releases.md
ADR-0027-versioning-tagging-and-releases.md
 
 
ADR-0028-standalone-ai-components.md
ADR-0028-standalone-ai-components.md
 
 
ADR-0029-agent-runtime-identity-and-profile-separation.md
ADR-0029-agent-runtime-identity-and-profile-separation.md
 
 
ADR-0030-provider-credential-and-model-policy-isolation.md
ADR-0030-provider-credential-and-model-policy-isolation.md
 
 
ADR-0031-rest-representation-contracts-and-api-evolution.md
ADR-0031-rest-representation-contracts-and-api-evolution.md
 
 
ADR-0032-language-neutral-multi-protocol-service-contracts.md
ADR-0032-language-neutral-multi-protocol-service-contracts.md
 
 
ADR-0033-composable-and-decoratable-contract-implementations.md
ADR-0033-composable-and-decoratable-contract-implementations.md
 
 
README.md
README.md
 
 
TEMPLATE.md
TEMPLATE.md
 
 

README.md

Architecture Decision Records

This directory is the canonical location for FlossWare ADRs.

ADR Format

Each ADR should contain:

  1. Status
  2. Date
  3. Context
  4. Scope (recommended; required for new ADRs)
  5. Non-goals (recommended; required for new ADRs)
  6. Decision
  7. Consequences
  8. Alternatives Considered
  9. Related ADRs

See TEMPLATE.md.

Numbering

ADR numbers are unique and sequential across the repository.

Normative Language

  • SHALL / SHALL NOT: required architectural constraints
  • SHOULD / SHOULD NOT: recommended patterns
  • MAY: optional choices

MUST / MUST NOT, if present in older text, are treated as equivalent to SHALL / SHALL NOT (RFC 2119).