Skip to content

Appcircle Technical Design Documents (TDD)

This page is the canonical entry point for Appcircle's technical design records. Each TDD captures the detailed architecture and component-level design of a new feature, refactor, or infrastructure change.

Once a design is Approved, it becomes a living reference for implementation and maintenance.

See the TDD Index for the full, up-to-date catalogue of all TDDs.

Status legend

  • 📝 Draft – In progress, under authoring.
  • 🧠 In Review – Under technical/architecture review.
  • ✅ Approved – Reviewed and accepted; in implementation or completed.
  • 🚫 Rejected – Considered but not adopted.
  • 🧪 Deprecated – Being phased out or replaced.

Tip: Keep TDDs detailed enough for engineers, concise enough for reviewers.

How to add a new TDD

  1. Pick the next sequential number (zero-padded), e.g. 0015.
  2. Create a file under docs/records/tdd/: 
    docs/records/tdd/0015-your-title.md
  3. Use template.md for the header and sections.
  4. Add a row for it in the TDD Index table.