AyCode.Core/AyCode.Services/docs/adr
Loretta c062ded9a4 [LOADED_DOCS: 3 files, no new loads]
Update ID format to use per-repo prefixes and random suffix

Migrated all issue, TODO, and decision IDs to a new 4-part format: <PREFIX>-<TOPIC>-<TYPE>-<RAND>. Added per-repo prefix declarations in copilot-instructions.md and documented conventions in REPO_PREFIXES.md. Updated all topic registries, logs, cross-references, and documentation to use the new format. Introduced MIGRATION_ID_MAPPING.md for old-to-new ID mapping. Enhanced skills and protocol audit logic to validate and enforce per-repo prefixes and topic codes at runtime. Clarified Framework-First doctrine and ensured all references are unambiguous.
2026-04-26 19:12:50 +02:00
..
0000-TEMPLATE.md [LOADED_DOCS: 3 files, no new loads] 2026-04-26 13:44:12 +02:00
0001-acbinary-decorator-feature-stack-design.md [LOADED_DOCS: 3 files, no new loads] 2026-04-26 19:12:50 +02:00
README.md [LOADED_DOCS: 3 files, no new loads] 2026-04-26 13:44:12 +02:00

README.md

Architecture Decision Records (ADRs)

Project-scoped Architecture Decision Records for AyCode.Services — design decisions specific to this project's internal architecture (binary hub protocol composition, SignalR client design, etc.). Repo-wide cross-cutting decisions live in AyCode.Core/docs/adr/, not here.

See .github/skills/adr-author/SKILL.md for the full authoring procedure (routing rules, Socratic interview, trade-off elicitation, draft → review → write).

Convention

  • Format: Nygard-style ADR; one file per decision.
  • Filename: NNNN-<slug>.md — zero-padded 4-digit sequence + kebab-case slug derived from the title (e.g. 0001-acbinary-decorator-feature-stack-design.md).
  • Numbering: sequential, append-only. Derive next NNNN from max(existing) + 1 at write time.
  • Template: copy 0000-TEMPLATE.md when starting a new ADR.
  • Status field: Proposed (YYYY-MM-DD)Accepted (YYYY-MM-DD) / Rejected (YYYY-MM-DD) / Superseded by ADR-XXXX (YYYY-MM-DD). Update in-place; entry body / ID / Decision text remain immutable.

Index

ID Title Status
0001 AcBinaryHubProtocol optional feature stack — decorator-based composition design Proposed (2026-04-25)