Tirsvad
08cb484498
Add the phase MIL-009 (proposed 2026-12-21 to 2026-12-23): after the framework is installed, the new project excludes .claude, .agents and AGENTS.md through its own .git/info/exclude, so no tracked file changes. The analysis and design documents agree with it: Business Case objective 5, US-001.03, UC-001 (postcondition, step 9, extension 9f, a rule), OC-001 (P15 and two exceptions), SD-001, DCD-001 and DCD-002 (excludeFromGit, trackedPaths), and the Framework Setup and Template definitions in DM-001, DM-002 and the dictionary. Refs #65 Refs #66 Refs #67 Refs #68 Refs #69
55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# Artifact Registry
|
|
|
|
This project's artifact state. Types, short names and `CrossReference
|
|
Candidates` come from the framework catalog
|
|
(`framework/registry/artifact-catalog.md`); this file only records where
|
|
each document lives in *this* project and the next version to use.
|
|
|
|
Delete rows for types you don't use. Add a row the first time you create a
|
|
document of a type. `Primary File` may contain a glob (e.g.
|
|
`docs/uc-*/uc.md`); `framework/scripts/find-crossreferences.sh` reads it.
|
|
|
|
| Short Name | Artifact Type | Primary File | Next Available Version |
|
|
| --- | --- | --- | --- |
|
|
| BC | Business Case | docs/business-case.md | 002 |
|
|
| SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 |
|
|
| PP | Project Plan | docs/project-plan.md | 002 |
|
|
| MIL | Milestone / Gateway | docs/milestones/*.md | 010 |
|
|
| US | User Story | docs/user-stories.md | 002 |
|
|
| UC | Use Case | docs/uc-*/uc.md | 003 |
|
|
| SSD | System Sequence Diagram | docs/uc-*/ssd.md | 003 |
|
|
| OC | Operation Contract | docs/uc-*/oc.md | 003 |
|
|
| SD | Sequence Diagram | docs/uc-*/sd.md | 003 |
|
|
| DM | Domain Model | docs/domain-model.md | 004 |
|
|
| DCD | Design Class Diagram | docs/dcd.md | 004 |
|
|
| DICT | Domain Dictionary (PO and IT terms) | docs/dictionary.md | 002 |
|
|
| UCD | Use Case Diagram | docs/use-case-diagram.md | 002 |
|
|
| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 032 |
|
|
| TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 |
|
|
|
|
## Languages
|
|
|
|
Set the PO language when the project starts; `project-planning` asks for it
|
|
if it is missing. A translated artifact is named `<artifact>.<language>.md`
|
|
(for example `business-case.da.md`); the English file stays the source.
|
|
|
|
| Setting | Value |
|
|
| --- | --- |
|
|
| PO language | en |
|
|
| High-level register | IT Executive English |
|
|
| Technical register | IT Professional English |
|
|
|
|
| Artifact types | Register | Also kept as a PO-language file |
|
|
| --- | --- | --- |
|
|
| BC, KPI, PP, MIL | IT Executive English | Yes |
|
|
| SA, BMC, BPMN, UCD, US, UC, SSD, DM, RA, GOV, DICT | IT Professional English | Yes |
|
|
| OC, SD, DCD, ERD, ADR, TM, RC, QC, source code | IT Professional English | No |
|
|
|
|
## Notes
|
|
|
|
- "Next Available Version" is the zero-padded (3-digit) version to use the
|
|
*next* time a new document of that type is created. Increment it only when
|
|
a brand-new document is created, not when an existing document's
|
|
`## Version History` gets a row.
|
|
- `ADR` uses 4 digits (`0001`); `RC` is sequential across all artifact types.
|