bisco/hoopscout-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: define architecture principles for phase 1

Browse Source
This commit is contained in:
bisco
2026-03-20 19:35:00 +01:00
parent d80d04b4ac
commit 78f45eb113
3 changed files with 67 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/PHASE_1.md
View File

@ -29,6 +29,7 @@ Until the phase-1 decision framework is complete, do not:
Phase 1 should produce:
- a maintained phase-1 decision plan
- a documented technical decision process
- a documented set of architecture principles and constraints
- a central architecture overview document
- a set of ADRs covering major technical choices
- clear implementation preconditions for the next phase
@ -39,16 +40,18 @@ Make decisions in this order:
1. Define the required decision areas.
2. Record the technical decision process and evaluation criteria.
3. Record the ADR process and naming conventions.
4. Establish the architecture overview and its relationship to ADRs.
5. Document major technical decisions in ADRs.
6. Confirm that implementation-critical choices are explicit and aligned.
3. Define the architecture principles and guiding constraints.
4. Record the ADR process and naming conventions.
5. Establish the architecture overview and its relationship to ADRs.
6. Document major technical decisions in ADRs.
7. Confirm that implementation-critical choices are explicit and aligned.
## Exit Criteria for Phase 1
Phase 1 is complete when:
- the decision framework is documented
- the technical decision process is documented and usable
- the architecture principles and constraints are documented
- the architecture overview exists and points to ADRs
- required major technical decisions are recorded as ADRs
- implementation can begin without relying on undocumented assumptions