From a1ff73580fdcfad5bbb3854298fdfa0c16ada853 Mon Sep 17 00:00:00 2001 From: Jens Tirsvad Nielsen Date: Sun, 4 Oct 2026 23:23:12 +0800 Subject: [PATCH 1/2] Accept BC, SA, PP and MIL-001 after review Review BC-001, SA-001, PP-001 and MIL-001 and record the results as RC-001 to RC-004. All four verdicts are Go, so their Version History rows become Accepted and the previous rows Deprecated. MIL-002 to MIL-004 stay Proposed. BC-001 failed criterion 1 (cost-benefit not justified as qualitative). Add the justification and a target-completion constraint (2026-10-14) that PP-001 and MIL-001 are checked against. Add the Traceability Matrix (TM-001) and register RC and TM in the artifact registry. PP has no QC checklist, so RC-003 checks the plan against BC-001 and the milestones instead. Author and reviewer are both S01, a deviation noted in each record. Refs #5 --- docs/artifact-registry.md | 2 + docs/business-case.md | 9 +- docs/milestones/mil-001-project-setup.md | 6 +- docs/project-plan.md | 194 +++++++++--------- docs/sqa/reviews/rc-001-business-case.md | 47 +++++ .../reviews/rc-002-stakeholder-analysis.md | 47 +++++ docs/sqa/reviews/rc-003-project-plan.md | 44 ++++ docs/sqa/reviews/rc-004-mil-001.md | 45 ++++ docs/sqa/traceability-matrix.md | 50 +++++ docs/stakeholder-analysis.md | 8 +- 10 files changed, 349 insertions(+), 103 deletions(-) create mode 100644 docs/sqa/reviews/rc-001-business-case.md create mode 100644 docs/sqa/reviews/rc-002-stakeholder-analysis.md create mode 100644 docs/sqa/reviews/rc-003-project-plan.md create mode 100644 docs/sqa/reviews/rc-004-mil-001.md create mode 100644 docs/sqa/traceability-matrix.md diff --git a/docs/artifact-registry.md b/docs/artifact-registry.md index 0544905..f586abf 100644 --- a/docs/artifact-registry.md +++ b/docs/artifact-registry.md @@ -15,6 +15,8 @@ document of a type. `Primary File` may contain a glob (e.g. | SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 | | PP | Project Plan | docs/project-plan.md | 002 | | MIL | Milestone / Gateway | docs/milestones/*.md | 005 | +| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 005 | +| TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 | ## Languages diff --git a/docs/business-case.md b/docs/business-case.md index 5dce7ff..1990cad 100644 --- a/docs/business-case.md +++ b/docs/business-case.md @@ -4,12 +4,13 @@ | Key | Value | | --- | --- | | ID | BC-001 | -| CrossReference | [SA-001], [PP-001] | +| CrossReference | [SA-001], [PP-001], [RC-001] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Added target-date constraint and cost-benefit justification
Accepted after review RC-001 | pending | --- @@ -99,6 +100,7 @@ Supports the author's goal of completing the 100 Days of Code bootcamp with prof - No runtime dependencies unless needed. - Do not commit, push or open a PR without the author's request. - Product Owner language: English. +- Target completion 2026-10-14 (proposed by S01; no external deadline). ## Cost–Benefit Assessment @@ -106,6 +108,8 @@ Supports the author's goal of completing the 100 Days of Code bootcamp with prof | --- | --- | | About one to two evenings of the author's time | A shareable, tested, documented reference solution | +The comparison is qualitative on purpose: this is a personal learning project with no revenue or budget, so a monetary ROI would be artificial. The cost is the author's time; the benefit is the shareable reference solution and practice gained. + ## Stakeholders | Stakeholder ID (SA) | Interest in this project | @@ -123,3 +127,4 @@ Proceed — the scope is small, the risks are low and the result serves all thre [SA-001]: ./stakeholder-analysis.md [PP-001]: ./project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d +[RC-001]: ./sqa/reviews/rc-001-business-case.md diff --git a/docs/milestones/mil-001-project-setup.md b/docs/milestones/mil-001-project-setup.md index e0d9c5f..24ee375 100644 --- a/docs/milestones/mil-001-project-setup.md +++ b/docs/milestones/mil-001-project-setup.md @@ -4,12 +4,13 @@ | Key | Value | | --- | --- | | ID | MIL-001 | -| CrossReference | [BC-001], [PP-001] | +| CrossReference | [BC-001], [PP-001], [RC-004] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-004 | pending | --- @@ -70,3 +71,4 @@ Decide whether the project foundation (configuration, layout, tooling files and [BC-001]: ../business-case.md [PP-001]: ../project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d +[RC-004]: ../sqa/reviews/rc-004-mil-001.md diff --git a/docs/project-plan.md b/docs/project-plan.md index 7df645c..1e0ca6f 100644 --- a/docs/project-plan.md +++ b/docs/project-plan.md @@ -1,96 +1,98 @@ -# Project Plan - -## Metadata -| Key | Value | -| --- | --- | -| ID | PP-001 | -| CrossReference | [BC-001], [SA-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004] | - -## Version History -| Date | Status | Author | Reviewer | Change | Commit | -| --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | - ---- - -## Purpose - -Schedule the four phases that deliver the Higher Lower game ([BC-001] objectives O1–O5) as a small, tested, documented Python project, with S01 reviewing each phase through its own branch and pull request. - -## Planning Assumptions - -- Week 1 starts 2026-10-04; the plan ends by 2026-10-14 (the Business Case sets no hard date; this is the author's evening-sized target, see Open Issues). -- One phase per branch and pull request, each closing its issues. -- Nothing under `src/` or `tests/` before the milestone is accepted and the task is a row in it. -- Only S01 reviews ([SA-001]). - -## Gateway Schedule - -| Gateway | Document | Window | Decision date | Owner | Stories | Main deliverable | Milestone | -| --- | --- | --- | --- | --- | --- | --- | --- | -| Project setup | [MIL-001] | 2026-10-04 – 2026-10-06 | 2026-10-06 | S01 | — | pyproject, Doxyfile, skeleton, repo metadata | | -| Game logic | [MIL-002] | 2026-10-07 – 2026-10-09 | 2026-10-09 | S01 | — | Data, art, constants, pure functions, tests | | -| Console game | [MIL-003] | 2026-10-10 – 2026-10-12 | 2026-10-12 | S01 | — | Playable game loop with score, tests | | -| Documentation and release | [MIL-004] | 2026-10-13 – 2026-10-14 | 2026-10-14 | S01 | — | README, Doxygen run, review records | | - -```plantuml -@startgantt -Project starts 2026-10-04 -[Project setup] starts 2026-10-04 and ends 2026-10-06 -[Project setup Go/No-Go] happens 2026-10-06 -[Game logic] starts 2026-10-07 and ends 2026-10-09 -[Game logic Go/No-Go] happens 2026-10-09 -[Console game] starts 2026-10-10 and ends 2026-10-12 -[Console game Go/No-Go] happens 2026-10-12 -[Documentation and release] starts 2026-10-13 and ends 2026-10-14 -[Documentation and release Go/No-Go] happens 2026-10-14 -@endgantt -``` - -## Scope Coverage - -| Business Case scope item | Gateway | -| --- | --- | -| `src/`, `tests/`, `docs/` layout, `pyproject.toml`, `.gitignore`, `Doxyfile` | [MIL-001] | -| Repository description and topics | [MIL-001] | -| Assignment data set, `logo` and `vs` art | [MIL-002] | -| Random pair selection, answer checking | [MIL-002] | -| Console game, score tracking | [MIL-003] | -| `README.md`, venv and test instructions | [MIL-004] | - -## Dependencies - -``` -MIL-001 → MIL-002 → MIL-003 → MIL-004 -``` - -A No-Go on any phase moves all later windows by the rework time. - -## Plan Risks - -| Risk | Impact | Mitigation | -| --- | --- | --- | -| README template not supplied | README task blocked | Ask S01 before MIL-004 starts | -| Host token missing or lacking scope | Cannot sync issues or set topics | Token read from `.env` for personal use only; ask S01 if absent | -| Doxygen not installed locally | Cannot verify docs build | Treat as a No-Go note; install or review comments manually | - -## Open Issues - -- README template: the brief says "using the template below" but none was included. Needed before MIL-004. -- Python version: "greater than 3.13" is planned as `>=3.13`; confirm if strictly 3.14+ is meant. -- Target dates are proposed, not stated in the brief; confirm. -- The brief links the organisation; the `origin` remote is the repository `014-higher_lower` within it, which is what will be synced. - ---- - -[BC-001]: ./business-case.md -[SA-001]: ./stakeholder-analysis.md -[MIL-001]: ./milestones/mil-001-project-setup.md -[MIL-002]: ./milestones/mil-002-game-logic.md -[MIL-003]: ./milestones/mil-003-console-game.md -[MIL-004]: ./milestones/mil-004-docs-release.md -[Milestone MIL-001]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/36 -[Milestone MIL-002]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/37 -[Milestone MIL-003]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/38 -[Milestone MIL-004]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/39 -[ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d +# Project Plan + +## Metadata +| Key | Value | +| --- | --- | +| ID | PP-001 | +| CrossReference | [BC-001], [SA-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [RC-003] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-003 | pending | + +--- + +## Purpose + +Schedule the four phases that deliver the Higher Lower game ([BC-001] objectives O1–O5) as a small, tested, documented Python project, with S01 reviewing each phase through its own branch and pull request. + +## Planning Assumptions + +- Week 1 starts 2026-10-04; the plan ends by 2026-10-14 (the Business Case sets no hard date; this is the author's evening-sized target, see Open Issues). +- One phase per branch and pull request, each closing its issues. +- Nothing under `src/` or `tests/` before the milestone is accepted and the task is a row in it. +- Only S01 reviews ([SA-001]). + +## Gateway Schedule + +| Gateway | Document | Window | Decision date | Owner | Stories | Main deliverable | Milestone | +| --- | --- | --- | --- | --- | --- | --- | --- | +| Project setup | [MIL-001] | 2026-10-04 – 2026-10-06 | 2026-10-06 | S01 | — | pyproject, Doxyfile, skeleton, repo metadata | | +| Game logic | [MIL-002] | 2026-10-07 – 2026-10-09 | 2026-10-09 | S01 | — | Data, art, constants, pure functions, tests | | +| Console game | [MIL-003] | 2026-10-10 – 2026-10-12 | 2026-10-12 | S01 | — | Playable game loop with score, tests | | +| Documentation and release | [MIL-004] | 2026-10-13 – 2026-10-14 | 2026-10-14 | S01 | — | README, Doxygen run, review records | | + +```plantuml +@startgantt +Project starts 2026-10-04 +[Project setup] starts 2026-10-04 and ends 2026-10-06 +[Project setup Go/No-Go] happens 2026-10-06 +[Game logic] starts 2026-10-07 and ends 2026-10-09 +[Game logic Go/No-Go] happens 2026-10-09 +[Console game] starts 2026-10-10 and ends 2026-10-12 +[Console game Go/No-Go] happens 2026-10-12 +[Documentation and release] starts 2026-10-13 and ends 2026-10-14 +[Documentation and release Go/No-Go] happens 2026-10-14 +@endgantt +``` + +## Scope Coverage + +| Business Case scope item | Gateway | +| --- | --- | +| `src/`, `tests/`, `docs/` layout, `pyproject.toml`, `.gitignore`, `Doxyfile` | [MIL-001] | +| Repository description and topics | [MIL-001] | +| Assignment data set, `logo` and `vs` art | [MIL-002] | +| Random pair selection, answer checking | [MIL-002] | +| Console game, score tracking | [MIL-003] | +| `README.md`, venv and test instructions | [MIL-004] | + +## Dependencies + +``` +MIL-001 → MIL-002 → MIL-003 → MIL-004 +``` + +A No-Go on any phase moves all later windows by the rework time. + +## Plan Risks + +| Risk | Impact | Mitigation | +| --- | --- | --- | +| README template not supplied | README task blocked | Ask S01 before MIL-004 starts | +| Host token missing or lacking scope | Cannot sync issues or set topics | Token read from `.env` for personal use only; ask S01 if absent | +| Doxygen not installed locally | Cannot verify docs build | Treat as a No-Go note; install or review comments manually | + +## Open Issues + +- README template: the brief says "using the template below" but none was included. Needed before MIL-004. +- Python version: "greater than 3.13" is planned as `>=3.13`; confirm if strictly 3.14+ is meant. +- Target dates are proposed, not stated in the brief; confirm. +- The brief links the organisation; the `origin` remote is the repository `014-higher_lower` within it, which is what will be synced. + +--- + +[BC-001]: ./business-case.md +[SA-001]: ./stakeholder-analysis.md +[MIL-001]: ./milestones/mil-001-project-setup.md +[MIL-002]: ./milestones/mil-002-game-logic.md +[MIL-003]: ./milestones/mil-003-console-game.md +[MIL-004]: ./milestones/mil-004-docs-release.md +[Milestone MIL-001]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/36 +[Milestone MIL-002]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/37 +[Milestone MIL-003]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/38 +[Milestone MIL-004]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/39 +[ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d +[RC-003]: ./sqa/reviews/rc-003-project-plan.md diff --git a/docs/sqa/reviews/rc-001-business-case.md b/docs/sqa/reviews/rc-001-business-case.md new file mode 100644 index 0000000..fea91b8 --- /dev/null +++ b/docs/sqa/reviews/rc-001-business-case.md @@ -0,0 +1,47 @@ +# SQA Review Record: Business Case + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-001 | +| CrossReference | [BC-001], [QC-BC-001] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [BC-001] +- Checklist used: [QC-BC-001] + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | ROI/Cost-Benefit analysis is quantitative, or where qualitative, is explicitly justified | Pass | Qualitative; justification paragraph added under Cost–Benefit Assessment (personal project, no revenue or budget). | +| 2 | Risks are identified with documented impact and mitigation | Pass | Three risks, each with impact and mitigation. | +| 3 | Success criteria are measurable, stating explicit targets | Pass | Five criteria with target and measure. | +| 4 | Scope explicitly separates In Scope vs Out of Scope | Pass | Separate subsections. | +| 5 | Stakeholders are cross-referenced to Stakeholder Analysis IDs | Pass | S01–S03 used; the table only states interest. | +| 6 | Methodology and quality-standard foundation are stated explicitly (Optional) | Pass | SQA/QC framework and ISO/IEC 25010:2023 named. | +| 7 | Assumptions and constraints are explicit and distinguished | Pass | Separate sections; target date added to Constraints. | +| 8 | Document supports executive decision-making with a clear recommendation | Pass | Recommendation: Proceed, with rationale. | + +## Overall Verdict + +Go — all mandatory and optional criteria pass. Reviewer and author are both S01: the project has a single participant, so the framework's author/reviewer separation cannot be met. S01 accepted this deviation when requesting acceptance (2026-10-04). + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| None | — | — | + +--- + +[BC-001]: ../../business-case.md +[QC-BC-001]: ../../../framework/qc/qc-business-case.md diff --git a/docs/sqa/reviews/rc-002-stakeholder-analysis.md b/docs/sqa/reviews/rc-002-stakeholder-analysis.md new file mode 100644 index 0000000..5f67674 --- /dev/null +++ b/docs/sqa/reviews/rc-002-stakeholder-analysis.md @@ -0,0 +1,47 @@ +# SQA Review Record: Stakeholder Analysis + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-002 | +| CrossReference | [SA-001], [QC-SA-001] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [SA-001] +- Checklist used: [QC-SA-001] + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | Power/Interest grid is filled for every stakeholder | Pass | S01–S03 all classified. | +| 2 | Each stakeholder has a unique, stable ID | Pass | S01, S02, S03. | +| 3 | Roles and organizational context defined with explicit Power and Interest levels | Pass | Summary table. | +| 4 | Communication needs mapped to phases or milestones (Optional) | Pass | Communication Requirements table cites MIL-001 to MIL-004. | +| 5 | Conflicting interests identified with mitigation | Pass | One conflict (tooling versus simple repository), mitigated. | +| 6 | Stakeholder concerns traced to Business Case objectives | Pass | Business Goal Alignment table cites O1–O5. | +| 7 | Concerns expressed in business language and FURPS+ (Optional) | Pass | FURPS+ mapping table. | +| 8 | Understandable by non-technical stakeholders (Optional) | Pass | Plain language, short document. | + +## Overall Verdict + +Go — all criteria pass. Reviewer and author are both S01: the project has a single participant, so the framework's author/reviewer separation cannot be met. S01 accepted this deviation when requesting acceptance (2026-10-04). + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| None | — | — | + +--- + +[SA-001]: ../../stakeholder-analysis.md +[QC-SA-001]: ../../../framework/qc/qc-stakeholder-analysis.md diff --git a/docs/sqa/reviews/rc-003-project-plan.md b/docs/sqa/reviews/rc-003-project-plan.md new file mode 100644 index 0000000..a60799c --- /dev/null +++ b/docs/sqa/reviews/rc-003-project-plan.md @@ -0,0 +1,44 @@ +# SQA Review Record: Project Plan + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-003 | +| CrossReference | [PP-001] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [PP-001] +- Checklist used: none exists for this type (`PP` has no QC checklist); criteria below follow `references/PP.md` "Validating". + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | Every MIL-* gateway is scheduled | Pass | MIL-001 to MIL-004 listed with window, decision date and owner. | +| 2 | Schedule is consistent with the Business Case constraint | Pass | Ends 2026-10-14, matching the target-date constraint added to BC-001. | +| 3 | Gateway Schedule, Gantt, Scope Coverage, Dependencies, Plan Risks and Open Issues sections are present | Pass | All required sections present. | +| 4 | Each phase links to its synced Milestone | Pass | Milestones 36–39 linked. | +| 5 | Every Business Case scope item maps to a gateway | Pass | Scope Coverage table. | + +## Overall Verdict + +Go — no QC checklist exists for PP, so the plan was checked against BC-001 and the MIL-* documents. Open issues (README template, Python version, dates) remain listed in the plan. Reviewer and author are both S01: the project has a single participant, so the framework's author/reviewer separation cannot be met. S01 accepted this deviation when requesting acceptance (2026-10-04). + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| Provide README template before MIL-004 task 1 | S01 | 2026-10-13 | +| Confirm requires-python (>=3.13 or 3.14+) | S01 | 2026-10-06 | + +--- + +[PP-001]: ../../project-plan.md diff --git a/docs/sqa/reviews/rc-004-mil-001.md b/docs/sqa/reviews/rc-004-mil-001.md new file mode 100644 index 0000000..b55a7af --- /dev/null +++ b/docs/sqa/reviews/rc-004-mil-001.md @@ -0,0 +1,45 @@ +# SQA Review Record: MIL-001 Project setup + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-004 | +| CrossReference | [MIL-001], [QC-MIL-001] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [MIL-001] +- Checklist used: [QC-MIL-001] + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | A concrete deliverable is defined for every gate | Pass | Config files, skeleton, passing smoke test, repository metadata. | +| 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | Six objectively checkable criteria. | +| 3 | Dependencies on other milestones are explicitly mapped (Optional) | Pass | First phase; stated as none. | +| 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | O2, O4, O5. | +| 5 | Milestone owner and approving reviewer are identified | Pass | S01 and S01. | +| 6 | Milestone has a target date consistent with project constraints | Pass | 2026-10-06, inside the 2026-10-14 constraint in BC-001. | + +## Overall Verdict + +Go — all criteria pass. MIL-002 to MIL-004 stay Proposed. Reviewer and author are both S01: the project has a single participant, so the framework's author/reviewer separation cannot be met. S01 accepted this deviation when requesting acceptance (2026-10-04). + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| Confirm requires-python before issue #1 starts | S01 | 2026-10-06 | + +--- + +[MIL-001]: ../../milestones/mil-001-project-setup.md +[QC-MIL-001]: ../../../framework/qc/qc-milestones-gateways.md diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md new file mode 100644 index 0000000..67e5a7b --- /dev/null +++ b/docs/sqa/traceability-matrix.md @@ -0,0 +1,50 @@ +# Traceability Matrix + +## Metadata +| Key | Value | +| --- | --- | +| ID | TM-001 | +| CrossReference | [BC-001] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Purpose + +Tracks backward/forward links between artifact instances so that the Business Case traceability +target is measurable. A row is added or updated whenever an artifact instance is created or reviewed. + +## Traceability Table + +| Artifact Instance | Type | Upstream (Backward Link) | Downstream (Forward Link) | Last Reviewed (RC-ID) | +| --- | --- | --- | --- | --- | +| [BC-001] | BC | - | [SA-001], [PP-001] | [RC-001] | +| [SA-001] | SA | [BC-001] | [PP-001] | [RC-002] | +| [PP-001] | PP | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004] | [RC-003] | +| [MIL-001] | MIL | [BC-001], [PP-001] | - | [RC-004] | +| [MIL-002] | MIL | [BC-001], [PP-001] | - | - | +| [MIL-003] | MIL | [BC-001], [PP-001] | - | - | +| [MIL-004] | MIL | [BC-001], [PP-001] | - | - | + +## Coverage Notes + +- No use cases, user stories or design artifacts exist yet (UC-001 is planned for MIL-003). +- `-` in Upstream means foundational; in Downstream, nothing is built on it yet; in Last Reviewed, no `RC-*` exists yet. + +--- + +[BC-001]: ../business-case.md +[SA-001]: ../stakeholder-analysis.md +[PP-001]: ../project-plan.md +[MIL-001]: ../milestones/mil-001-project-setup.md +[MIL-002]: ../milestones/mil-002-game-logic.md +[MIL-003]: ../milestones/mil-003-console-game.md +[MIL-004]: ../milestones/mil-004-docs-release.md +[RC-001]: ./reviews/rc-001-business-case.md +[RC-002]: ./reviews/rc-002-stakeholder-analysis.md +[RC-003]: ./reviews/rc-003-project-plan.md +[RC-004]: ./reviews/rc-004-mil-001.md diff --git a/docs/stakeholder-analysis.md b/docs/stakeholder-analysis.md index b7917dc..b5e5ec8 100644 --- a/docs/stakeholder-analysis.md +++ b/docs/stakeholder-analysis.md @@ -4,12 +4,13 @@ | Key | Value | | --- | --- | | ID | SA-001 | -| CrossReference | [BC-001], [PP-001] | +| CrossReference | [BC-001], [PP-001], [RC-002] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-002 | pending | --- @@ -70,10 +71,11 @@ Identify who is affected by the Higher Lower project and what each needs, using | Stakeholder | Decision | Date | | --- | --- | --- | -| S01 | Pending review | | +| S01 | Go (RC-002) | 2026-10-04 | --- [BC-001]: ./business-case.md [PP-001]: ./project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d +[RC-002]: ./sqa/reviews/rc-002-stakeholder-analysis.md From 529b96448131c04a94a599d74cb6f5eaa629dd77 Mon Sep 17 00:00:00 2001 From: Jens Tirsvad Nielsen Date: Sun, 4 Oct 2026 23:23:54 +0800 Subject: [PATCH 2/2] Resolve pending commit links for accepted documents Co-Authored-By: Claude Sonnet 5.5 --- docs/business-case.md | 3 ++- docs/milestones/mil-001-project-setup.md | 3 ++- docs/project-plan.md | 3 ++- docs/sqa/reviews/rc-001-business-case.md | 3 ++- docs/sqa/reviews/rc-002-stakeholder-analysis.md | 3 ++- docs/sqa/reviews/rc-003-project-plan.md | 3 ++- docs/sqa/reviews/rc-004-mil-001.md | 3 ++- docs/sqa/traceability-matrix.md | 3 ++- docs/stakeholder-analysis.md | 3 ++- 9 files changed, 18 insertions(+), 9 deletions(-) diff --git a/docs/business-case.md b/docs/business-case.md index 1990cad..c1489ab 100644 --- a/docs/business-case.md +++ b/docs/business-case.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Added target-date constraint and cost-benefit justification
Accepted after review RC-001 | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Added target-date constraint and cost-benefit justification
Accepted after review RC-001 | [a1ff735] | --- @@ -128,3 +128,4 @@ Proceed — the scope is small, the risks are low and the result serves all thre [PP-001]: ./project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d [RC-001]: ./sqa/reviews/rc-001-business-case.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/milestones/mil-001-project-setup.md b/docs/milestones/mil-001-project-setup.md index 24ee375..34bd368 100644 --- a/docs/milestones/mil-001-project-setup.md +++ b/docs/milestones/mil-001-project-setup.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-004 | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-004 | [a1ff735] | --- @@ -72,3 +72,4 @@ Decide whether the project foundation (configuration, layout, tooling files and [PP-001]: ../project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d [RC-004]: ../sqa/reviews/rc-004-mil-001.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/project-plan.md b/docs/project-plan.md index 1e0ca6f..c7b00e4 100644 --- a/docs/project-plan.md +++ b/docs/project-plan.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-003 | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-003 | [a1ff735] | --- @@ -96,3 +96,4 @@ A No-Go on any phase moves all later windows by the rework time. [Milestone MIL-004]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/milestones/39 [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d [RC-003]: ./sqa/reviews/rc-003-project-plan.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/sqa/reviews/rc-001-business-case.md b/docs/sqa/reviews/rc-001-business-case.md index fea91b8..3b5ec35 100644 --- a/docs/sqa/reviews/rc-001-business-case.md +++ b/docs/sqa/reviews/rc-001-business-case.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | [a1ff735] | --- @@ -45,3 +45,4 @@ Go — all mandatory and optional criteria pass. Reviewer and author are both S0 [BC-001]: ../../business-case.md [QC-BC-001]: ../../../framework/qc/qc-business-case.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/sqa/reviews/rc-002-stakeholder-analysis.md b/docs/sqa/reviews/rc-002-stakeholder-analysis.md index 5f67674..be4e12f 100644 --- a/docs/sqa/reviews/rc-002-stakeholder-analysis.md +++ b/docs/sqa/reviews/rc-002-stakeholder-analysis.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | [a1ff735] | --- @@ -45,3 +45,4 @@ Go — all criteria pass. Reviewer and author are both S01: the project has a si [SA-001]: ../../stakeholder-analysis.md [QC-SA-001]: ../../../framework/qc/qc-stakeholder-analysis.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/sqa/reviews/rc-003-project-plan.md b/docs/sqa/reviews/rc-003-project-plan.md index a60799c..7f4d3bb 100644 --- a/docs/sqa/reviews/rc-003-project-plan.md +++ b/docs/sqa/reviews/rc-003-project-plan.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | [a1ff735] | --- @@ -42,3 +42,4 @@ Go — no QC checklist exists for PP, so the plan was checked against BC-001 and --- [PP-001]: ../../project-plan.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/sqa/reviews/rc-004-mil-001.md b/docs/sqa/reviews/rc-004-mil-001.md index b55a7af..aaf1d66 100644 --- a/docs/sqa/reviews/rc-004-mil-001.md +++ b/docs/sqa/reviews/rc-004-mil-001.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | [a1ff735] | --- @@ -43,3 +43,4 @@ Go — all criteria pass. MIL-002 to MIL-004 stay Proposed. Reviewer and author [MIL-001]: ../../milestones/mil-001-project-setup.md [QC-MIL-001]: ../../../framework/qc/qc-milestones-gateways.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md index 67e5a7b..4c2dd00 100644 --- a/docs/sqa/traceability-matrix.md +++ b/docs/sqa/traceability-matrix.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-04 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [a1ff735] | --- @@ -48,3 +48,4 @@ target is measurable. A row is added or updated whenever an artifact instance is [RC-002]: ./reviews/rc-002-stakeholder-analysis.md [RC-003]: ./reviews/rc-003-project-plan.md [RC-004]: ./reviews/rc-004-mil-001.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853 diff --git a/docs/stakeholder-analysis.md b/docs/stakeholder-analysis.md index b5e5ec8..69e4cfe 100644 --- a/docs/stakeholder-analysis.md +++ b/docs/stakeholder-analysis.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-04 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [ddfe96f] | -| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-002 | pending | +| 2026-10-04 | Accepted | Jens Tirsvad Nielsen | S01 | Accepted after review RC-002 | [a1ff735] | --- @@ -79,3 +79,4 @@ Identify who is affected by the Higher Lower project and what each needs, using [PP-001]: ./project-plan.md [ddfe96f]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/ddfe96ffa459d5e4b2e30d71bd53878aba2cfc5d [RC-002]: ./sqa/reviews/rc-002-stakeholder-analysis.md +[a1ff735]: https://git.tirsystem.com/Tirsvad-Udemy-100_days_of_code/014-higher_lower/commit/a1ff73580fdcfad5bbb3854298fdfa0c16ada853