From 9aeb74e8b09bb7882847e9bd5d569dbc9856fc03 Mon Sep 17 00:00:00 2001 From: Jens Tirsvad Nielsen Date: Tue, 13 Oct 2026 22:37:52 +0800 Subject: [PATCH 1/2] PP-001: add MIL-008 and review record RC-062 MIL-008 (wiki publishing as a reusable workflow) joins the Gateway Schedule, the Gantt, Scope Coverage, Dependencies and Plan Risks. RC-062 records the review; the plan row stays Proposed until S01 gives the Go. --- docs/artifact-registry.md | 2 +- docs/project-plan.md | 17 +++++--- docs/sqa/reviews/rc-062-pp-001-mil-008.md | 53 +++++++++++++++++++++++ docs/sqa/traceability-matrix.md | 11 ++--- 4 files changed, 72 insertions(+), 11 deletions(-) create mode 100644 docs/sqa/reviews/rc-062-pp-001-mil-008.md diff --git a/docs/artifact-registry.md b/docs/artifact-registry.md index 5a2de19..f4ff96d 100644 --- a/docs/artifact-registry.md +++ b/docs/artifact-registry.md @@ -11,7 +11,7 @@ each document lives in *this* project and the next version to use. | SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 | | PP | Project Plan | docs/project-plan.md | 002 | | MIL | Milestone / Gateway | docs/milestones/*.md | 009 | -| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 062 | +| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 063 | | TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 | | ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0010 | | UCD | Use Case Diagram | docs/use-case-diagram.md | 002 | diff --git a/docs/project-plan.md b/docs/project-plan.md index 58eb718..188d4e6 100644 --- a/docs/project-plan.md +++ b/docs/project-plan.md @@ -4,25 +4,25 @@ | Key | Value | | --- | --- | | ID | PP-001 | -| CrossReference | [BC-001], [SA-001], [ADR-0002], [US-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007] | +| CrossReference | [BC-001], [SA-001], [ADR-0002], [US-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-10 | Deprecated | Jens Tirsvad Nielsen | S01 | Dates confirmed by S01 (stand-in for S05); the confirmation item is removed from Open Issues | [ea06eaa] | | 2026-10-11 | Accepted | Jens Tirsvad Nielsen | S01 | Added MIL-007 (quality checks for C++ and C#); reviewed (RC-053) | [e3ad1fa] | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-008 (wiki publishing as a reusable workflow); review RC-062 awaits S01 | pending | --- ## Purpose -This plan schedules seven milestones that move the repository from one +This plan schedules eight milestones that move the repository from one workflow with known defects to a documented, versioned collection of shared workflows. The Business Case sets no deadline, so the dates are the plan's own; they were confirmed on 2026-10-10 by S01, standing in for S05 (ADR-0002). ## Planning Assumptions -- Week 1 starts 2026-10-05; phases are two weeks long; the last decision is 2026-12-26; MIL-007 follows in January 2027 (2027-01-04 to 2027-01-16, confirmed on 2026-10-11 by S01). +- Week 1 starts 2026-10-05; phases are two weeks long; the last decision is 2026-12-26; MIL-007 follows in January 2027 (2027-01-04 to 2027-01-16, confirmed on 2026-10-11 by S01). MIL-008 amends the shared wiki publishing of MIL-006 and runs in parallel with the October and November windows: its work started on 2026-10-13 and its decision date is its own Target Date, 2026-11-15. - Work on a milestone starts only after its `MIL-*` document is `Accepted`. - Dates were confirmed on 2026-10-10 by S01, standing in for S05 (ADR-0002). @@ -37,6 +37,7 @@ workflows. The Business Case sets no deadline, so the dates are the plan's own; | Wiki and translations | [MIL-005] | 2026-11-30 to 2026-12-12 | 2026-12-12 | S05 | None yet | Wiki pages in English, Danish and Bahasa Malaysia, kept current by every pull request | [Milestone MIL-005] | | Shared wiki publishing | [MIL-006] | 2026-12-14 to 2026-12-26 | 2026-12-26 | S05 | None yet | Scoped publish-wiki workflow with opt-in, piloted in one other repository | [Milestone MIL-006] | | Quality checks for C++ and C# | [MIL-007] | 2027-01-04 to 2027-01-16 | 2027-01-16 | S05 | US-001.09, US-001.10 (to extend) | Reusable quality-check workflows for C++ and C#, released | [Milestone MIL-007] | +| Wiki publishing as a reusable workflow | [MIL-008] | 2026-10-13 to 2026-11-15 | 2026-11-15 | S05 | None yet | Reusable publish-wiki-pages workflow, wiki in docs/wiki, scoped workflow deprecated, released as 1.2.2 | [Milestone MIL-008] | ```plantuml @startgantt @@ -55,6 +56,8 @@ Project starts 2026-10-05 [MIL-006 Go/No-Go] happens 2026-12-26 [MIL-007 C++ and C#] starts 2027-01-04 and ends 2027-01-16 [MIL-007 Go/No-Go] happens 2027-01-16 +[MIL-008 Reusable wiki workflow] starts 2026-10-13 and ends 2026-11-15 +[MIL-008 Go/No-Go] happens 2026-11-15 @endgantt ``` @@ -69,6 +72,7 @@ Project starts 2026-10-05 | Wiki pages in English, Danish and Bahasa Malaysia | [MIL-005] | | The wiki publisher shared with other repositories through scoped delivery | [MIL-006] | | Gitea Actions workflows for software engineers (quality checks for C++ and C#) | [MIL-007] | +| The wiki publisher as a workflow that repositories call, from docs/wiki | [MIL-008] | ## Dependencies @@ -76,6 +80,7 @@ Project starts 2026-10-05 MIL-001 → MIL-002 → MIL-003 → MIL-004 MIL-002 → MIL-005 → MIL-006 MIL-003 + MIL-004 → MIL-007 + MIL-006 → MIL-008 ``` A No-Go moves every later window by the rework time of the failed milestone. @@ -86,6 +91,7 @@ A No-Go moves every later window by the rework time of the failed milestone. | --- | --- | --- | | The runner cannot provide the C++ or C# tools (MIL-007) | The workflows need a custom runner image or a longer install | MIL-007 task 2 verifies it first; the ADR of task 3 says what a build-dependent check needs from the caller. | | Reusable workflow support is missing on the instance | MIL-003 and MIL-004 change shape | Verify first in each milestone (MIL-002 task 2, MIL-003 task 1); fall back to copied templates. | +| Eight repositories still publish through the scoped workflow that MIL-008 deprecates (MIL-008 task 5) | Removing it would stop their wikis | It is deprecated and kept; a follow-up milestone migrates them and removes it in a major release (RC-061). | | Security review by S05 is a bottleneck | Milestone decisions slip | Keep milestones small and plan review time before each decision date. | ## Open Issues @@ -258,6 +264,7 @@ no tests, no release process. [MIL-005]: ./milestones/mil-005-wiki-and-translations.md [MIL-006]: ./milestones/mil-006-shared-wiki-publishing.md [MIL-007]: ./milestones/mil-007-cpp-csharp-quality-checks.md +[MIL-008]: ./milestones/mil-008-wiki-reusable-workflow.md [Milestone MIL-001]: https://git.tirsystem.com/TirSystem/github-action/milestone/18 [Milestone MIL-002]: https://git.tirsystem.com/TirSystem/github-action/milestone/19 [Milestone MIL-003]: https://git.tirsystem.com/TirSystem/github-action/milestone/20 @@ -265,6 +272,6 @@ no tests, no release process. [Milestone MIL-005]: https://git.tirsystem.com/TirSystem/github-action/milestone/93 [Milestone MIL-006]: https://git.tirsystem.com/TirSystem/github-action/milestone/94 [Milestone MIL-007]: https://git.tirsystem.com/TirSystem/github-action/milestone/95 -[ea06eaa]: https://git.tirsystem.com/TirSystem/github-action/commit/ea06eaaa698247d20e4a8e2694d7acbb1de58b63 +[Milestone MIL-008]: https://git.tirsystem.com/TirSystem/github-action/milestone/152 [b74ee0e]: https://git.tirsystem.com/TirSystem/github-action/commit/b74ee0e5cfd04f25ba5f2c1addc80699147c479a [e3ad1fa]: https://git.tirsystem.com/TirSystem/github-action/commit/e3ad1fa7e7eef57a6793a479edb41ac6fd2db688 diff --git a/docs/sqa/reviews/rc-062-pp-001-mil-008.md b/docs/sqa/reviews/rc-062-pp-001-mil-008.md new file mode 100644 index 0000000..5cccd07 --- /dev/null +++ b/docs/sqa/reviews/rc-062-pp-001-mil-008.md @@ -0,0 +1,53 @@ +# Review Record: PP-001 Project Plan (MIL-008) + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-062 | +| CrossReference | [PP-001], [BC-001], [MIL-008] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [PP-001] +- Checklist used: none: the Project Plan has no QC checklist. Validated against the Business Case [BC-001] and the Go / No-Go criteria of each listed milestone, as `PP.md` prescribes. +- Scope: delta re-review for the added MIL-008 row, Gantt entries, Scope Coverage, Dependencies, one Plan Risk and the counts; the earlier record is RC-053 +- Language and domain: n/a (technical type) +- Mode: supervised (the AI prepared the record; the Go is S01's and is not yet given) + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | Every milestone in the plan has a `MIL-*` document and the plan's dates equal that document's target date | Pass | MIL-001 to MIL-008 exist; the MIL-008 decision date 2026-11-15 equals its Target Date. | +| 2 | Every Business Case scope item is covered by a gateway | Pass | The wiki publisher shared with other repositories is covered by MIL-006 and MIL-008 (O2, O3). | +| 3 | The schedule respects the Business Case constraints | Pass | The Business Case sets no deadline; the MIL-008 window overlaps the October and November windows and says so under Planning Assumptions. | +| 4 | Dependencies between milestones are stated | Pass | MIL-006 to MIL-008 is in the Dependencies diagram and in MIL-008's own document. | +| 5 | Every gateway has an owner who is a stakeholder ID | Pass | MIL-008 is owned by S05. | +| 6 | Plan content is internally consistent | Pass | "Eight milestones", the Planning Assumptions, the Gantt entries, the Gateway Schedule and the Scope Coverage agree. | +| 7 | Open Issues are current | Pass | Unchanged items remain open; a plan risk was added for the repositories that still use the scoped workflow. | + +## Overall Verdict + +Go proposed - all seven criteria pass; no findings. The record and the plan row stay `Proposed` until S01 gives the Go, because the plan is S01's decision and the AI does not stand in for it in supervised mode. + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| Give the Go (or the findings) on the plan change, then set PP-001 and this record to `Accepted` | S01 | before the pull request is merged | +| Review ADR-0009 (still without a review record) | S01 | after the plan | + +--- + +--- + +[PP-001]: ../../project-plan.md +[BC-001]: ../../business-case.md +[MIL-008]: ../../milestones/mil-008-wiki-reusable-workflow.md diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md index 5574067..4da410d 100644 --- a/docs/sqa/traceability-matrix.md +++ b/docs/sqa/traceability-matrix.md @@ -4,13 +4,13 @@ | Key | Value | | --- | --- | | ID | TM-001 | -| CrossReference | [BC-001], [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [RC-001], [RC-002], [RC-003], [RC-004], [RC-005], [RC-006], [RC-007], [RC-008], [RC-009], [RC-010], [RC-011], [RC-012], [RC-013], [RC-014], [RC-015], [RC-016], [RC-017], [RC-018], [RC-019], [RC-020], [RC-021], [RC-022], [RC-023], [RC-024], [RC-025], [RC-026], [RC-027], [RC-028], [RC-029], [RC-030], [RC-031], [RC-032], [RC-033], [RC-034], [RC-035], [RC-036], [RC-037], [RC-038], [RC-039], [RC-040], [RC-041], [RC-042], [RC-043], [RC-044], [RC-045], [RC-046], [RC-047], [RC-048], [RC-049], [RC-050], [RC-051], [RC-052], [RC-053], [RC-054], [RC-055], [RC-056], [RC-057], [RC-058], [RC-059], [RC-060], [ADR-0007], [ADR-0008], [UC-007], [UC-006], [ADR-0006], [UC-005], [ADR-0005], [UCD-001], [US-001], [UC-001], [UC-002], [UC-003], [UC-004], [ADR-0001], [ADR-0002], [ADR-0003], [ADR-0004] | +| CrossReference | [BC-001], [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [RC-001], [RC-002], [RC-003], [RC-004], [RC-005], [RC-006], [RC-007], [RC-008], [RC-009], [RC-010], [RC-011], [RC-012], [RC-013], [RC-014], [RC-015], [RC-016], [RC-017], [RC-018], [RC-019], [RC-020], [RC-021], [RC-022], [RC-023], [RC-024], [RC-025], [RC-026], [RC-027], [RC-028], [RC-029], [RC-030], [RC-031], [RC-032], [RC-033], [RC-034], [RC-035], [RC-036], [RC-037], [RC-038], [RC-039], [RC-040], [RC-041], [RC-042], [RC-043], [RC-044], [RC-045], [RC-046], [RC-047], [RC-048], [RC-049], [RC-050], [RC-051], [RC-052], [RC-053], [RC-054], [RC-055], [RC-056], [RC-057], [RC-058], [RC-059], [RC-060], [RC-061], [RC-062], [ADR-0007], [ADR-0008], [UC-007], [UC-006], [ADR-0006], [UC-005], [ADR-0005], [UCD-001], [US-001], [UC-001], [UC-002], [UC-003], [UC-004], [ADR-0001], [ADR-0002], [ADR-0003], [ADR-0004] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-059 (MIL-007 task 7 results) | [2481c26] | | 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-008, RC-060 and RC-061 | [01b9c29] | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-062 (PP-001 with MIL-008) and the MIL-008 to PP-001 link | pending | --- @@ -26,7 +26,7 @@ updated whenever an artifact instance is created or reviewed. | --- | --- | --- | --- | --- | | [SA-001] | SA | - | [BC-001], [UCD-001] | [RC-004] | | [BC-001] | BC | [SA-001] | [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006] | [RC-001], [RC-008] | -| [PP-001] | PP | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [US-001] | [RC-002], [RC-009], [RC-015], [RC-017], [RC-025], [RC-032], [RC-053] | +| [PP-001] | PP | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [US-001] | [RC-002], [RC-009], [RC-015], [RC-017], [RC-025], [RC-032], [RC-053], [RC-062] | | [MIL-001] | MIL | [BC-001], [PP-001] | [MIL-002] | [RC-003], [RC-026] | | [MIL-002] | MIL | [BC-001], [PP-001], [MIL-001] | [MIL-003], [MIL-005] | [RC-005], [RC-027] | | [MIL-003] | MIL | [BC-001], [PP-001], [MIL-002] | [MIL-004] | [RC-006], [RC-028], [RC-033], [RC-039] | @@ -40,7 +40,7 @@ updated whenever an artifact instance is created or reviewed. | [MIL-005] | MIL | [BC-001], [PP-001], [MIL-002] | [MIL-006] | [RC-010], [RC-011], [RC-030], [RC-050] | | [MIL-006] | MIL | [BC-001], [PP-001], [MIL-002], [MIL-005] | - | [RC-016], [RC-031], [RC-049], [RC-058] | | [MIL-007] | MIL | [BC-001], [PP-001], [MIL-003], [MIL-004], [ADR-0008] | - | [RC-052], [RC-055], [RC-059] | -| [MIL-008] | MIL | [BC-001], [MIL-006], [ADR-0004] | - | [RC-060], [RC-061] | +| [MIL-008] | MIL | [BC-001], [PP-001], [MIL-006], [ADR-0004] | - | [RC-060], [RC-061] | | [RC-007] | RC | [MIL-004] | - | - | | [RC-008] | RC | [BC-001] | - | - | | [RC-009] | RC | [PP-001] | - | - | @@ -113,6 +113,7 @@ updated whenever an artifact instance is created or reviewed. | [RC-059] | RC | [MIL-007] | - | - | | [RC-060] | RC | [MIL-008] | - | - | | [RC-061] | RC | [MIL-008] | - | - | +| [RC-062] | RC | [PP-001] | - | - | ## Coverage Notes @@ -205,6 +206,7 @@ updated whenever an artifact instance is created or reviewed. [RC-059]: ./reviews/rc-059-mil-007-adoption.md [RC-060]: ./reviews/rc-060-mil-008-plan.md [RC-061]: ./reviews/rc-061-mil-008-task-5-deferred.md +[RC-062]: ./reviews/rc-062-pp-001-mil-008.md [ADR-0008]: ../adr/adr-0008-cpp-csharp-quality-check-contract.md [ADR-0007]: ../adr/adr-0007-release-publish-destination.md [UC-007]: ../uc-007/uc.md @@ -214,5 +216,4 @@ updated whenever an artifact instance is created or reviewed. [ADR-0005]: ../adr/adr-0005-quality-check-contract.md [faf13b2]: https://git.tirsystem.com/TirSystem/github-action/commit/faf13b2c2a4901c0171977de1ffc2841023f537a [1bc56f8]: https://git.tirsystem.com/TirSystem/github-action/commit/1bc56f8b771531f221f218fc00b147ecc73c051e -[2481c26]: https://git.tirsystem.com/TirSystem/github-action/commit/2481c26d802464decd51d75539157093b60e08e8 [01b9c29]: https://git.tirsystem.com/TirSystem/github-action/commit/01b9c2972b4317bcc590540010aea0eaf7f30014 From 672bc2988edacbae38fd7bc57f61535480ba05cb Mon Sep 17 00:00:00 2001 From: Jens Tirsvad Nielsen Date: Tue, 13 Oct 2026 22:37:54 +0800 Subject: [PATCH 2/2] Resolve pending commit links --- docs/project-plan.md | 3 ++- docs/sqa/reviews/rc-062-pp-001-mil-008.md | 3 ++- docs/sqa/traceability-matrix.md | 3 ++- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/project-plan.md b/docs/project-plan.md index 188d4e6..6f73f68 100644 --- a/docs/project-plan.md +++ b/docs/project-plan.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-11 | Accepted | Jens Tirsvad Nielsen | S01 | Added MIL-007 (quality checks for C++ and C#); reviewed (RC-053) | [e3ad1fa] | -| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-008 (wiki publishing as a reusable workflow); review RC-062 awaits S01 | pending | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-008 (wiki publishing as a reusable workflow); review RC-062 awaits S01 | [9aeb74e] | --- @@ -275,3 +275,4 @@ no tests, no release process. [Milestone MIL-008]: https://git.tirsystem.com/TirSystem/github-action/milestone/152 [b74ee0e]: https://git.tirsystem.com/TirSystem/github-action/commit/b74ee0e5cfd04f25ba5f2c1addc80699147c479a [e3ad1fa]: https://git.tirsystem.com/TirSystem/github-action/commit/e3ad1fa7e7eef57a6793a479edb41ac6fd2db688 +[9aeb74e]: https://git.tirsystem.com/TirSystem/github-action/commit/9aeb74e8b09bb7882847e9bd5d569dbc9856fc03 diff --git a/docs/sqa/reviews/rc-062-pp-001-mil-008.md b/docs/sqa/reviews/rc-062-pp-001-mil-008.md index 5cccd07..95147b8 100644 --- a/docs/sqa/reviews/rc-062-pp-001-mil-008.md +++ b/docs/sqa/reviews/rc-062-pp-001-mil-008.md @@ -9,7 +9,7 @@ ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | pending | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Initial version | [9aeb74e] | --- @@ -51,3 +51,4 @@ Go proposed - all seven criteria pass; no findings. The record and the plan row [PP-001]: ../../project-plan.md [BC-001]: ../../business-case.md [MIL-008]: ../../milestones/mil-008-wiki-reusable-workflow.md +[9aeb74e]: https://git.tirsystem.com/TirSystem/github-action/commit/9aeb74e8b09bb7882847e9bd5d569dbc9856fc03 diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md index 4da410d..1216a01 100644 --- a/docs/sqa/traceability-matrix.md +++ b/docs/sqa/traceability-matrix.md @@ -10,7 +10,7 @@ | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | | 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-008, RC-060 and RC-061 | [01b9c29] | -| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-062 (PP-001 with MIL-008) and the MIL-008 to PP-001 link | pending | +| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-062 (PP-001 with MIL-008) and the MIL-008 to PP-001 link | [9aeb74e] | --- @@ -217,3 +217,4 @@ updated whenever an artifact instance is created or reviewed. [faf13b2]: https://git.tirsystem.com/TirSystem/github-action/commit/faf13b2c2a4901c0171977de1ffc2841023f537a [1bc56f8]: https://git.tirsystem.com/TirSystem/github-action/commit/1bc56f8b771531f221f218fc00b147ecc73c051e [01b9c29]: https://git.tirsystem.com/TirSystem/github-action/commit/01b9c2972b4317bcc590540010aea0eaf7f30014 +[9aeb74e]: https://git.tirsystem.com/TirSystem/github-action/commit/9aeb74e8b09bb7882847e9bd5d569dbc9856fc03