From d7d0dacccb8701dfe643903eabfada65f9b54416 Mon Sep 17 00:00:00 2001 From: Thorsten Hindermann Date: Sat, 25 Jul 2026 18:38:55 +0200 Subject: [PATCH 1/2] chore: adopt learner accessibility preset patches --- .agents/skills/speckit-autonomous/SKILL.md | 6 + .agents/skills/speckit-intake-create/SKILL.md | 4 + .agents/skills/speckit-intake-delete/SKILL.md | 2 +- .agents/skills/speckit-intake-review/SKILL.md | 4 + .../speckit-intake-series-create/SKILL.md | 4 + .../speckit-parallel-autonomous/SKILL.md | 6 + .claude/skills/speckit-autonomous/SKILL.md | 8 +- .claude/skills/speckit-intake-create/SKILL.md | 6 +- .claude/skills/speckit-intake-delete/SKILL.md | 4 +- .claude/skills/speckit-intake-review/SKILL.md | 6 +- .../speckit-intake-series-create/SKILL.md | 6 +- .../speckit-parallel-autonomous/SKILL.md | 8 +- .github/agents/speckit.autonomous.agent.md | 8 +- .github/agents/speckit.intake-create.agent.md | 6 +- .github/agents/speckit.intake-delete.agent.md | 4 +- .github/agents/speckit.intake-review.agent.md | 6 +- .../speckit.intake-series-create.agent.md | 6 +- .../speckit.parallel-autonomous.agent.md | 8 +- .opencode/command/speckit.autonomous.md | 8 +- .opencode/command/speckit.intake-create.md | 6 +- .opencode/command/speckit.intake-delete.md | 4 +- .opencode/command/speckit.intake-review.md | 6 +- .../command/speckit.intake-series-create.md | 6 +- .../command/speckit.parallel-autonomous.md | 8 +- .specify/presets/.registry | 176 +++++++++--------- .specify/presets/a11y-governance/README.md | 16 +- .specify/presets/a11y-governance/preset.yml | 2 +- .../templates/agent-file-addendum.md | 5 + .../templates/constitution-addendum.md | 6 + .../templates/plan-addendum.md | 4 + .../templates/spec-addendum.md | 4 + .../templates/tasks-addendum.md | 4 + .../presets/agent-parity-governance/README.md | 23 ++- .../agent-parity-governance/preset.yml | 2 +- .../templates/agent-file-addendum.md | 5 + .../agent-parity-checklist-template.md | 2 + .../autonomous-run-governance/README.md | 13 +- .../commands/speckit.autonomous.md | 6 + .../docs/compatibility.md | 16 +- .../docs/getting-started.md | 12 +- .../man/validate-autonomous-gate-evidence.1 | 2 +- .../docs/man/validate-autonomous-run-state.1 | 2 +- .../autonomous-run-governance/preset.yml | 2 +- .../templates/agent-file-addendum.md | 6 + .../intake-authoring-governance/README.md | 15 +- .../commands/speckit.intake-create.md | 4 + .../commands/speckit.intake-delete.md | 2 +- .../man/validate-intake-authoring-artifact.1 | 2 +- .../man/validate-intake-authoring-receipt.1 | 2 +- .../intake-authoring-governance/preset.yml | 2 +- .../validate-intake-authoring-receipt.ps1 | 2 +- .../validate-intake-authoring-receipt.sh | 2 +- .../intake-authoring-receipt-template.json | 2 +- .../templates/intake-template.md | 5 + .../templates/project-profile-template.md | 10 + .../tests/test-intake-authoring-lifecycle.ps1 | 2 +- .../intake-review-governance/README.md | 9 +- .../commands/speckit.intake-review.md | 4 + .../intake-review-governance/docs/README.md | 2 +- .../docs/field-validation-summary.md | 8 +- .../docs/man/validate-intake-review-result.1 | 2 +- .../intake-review-governance/preset.yml | 2 +- .../intake-review-checklist-template.md | 6 + .../intake-sequencing-governance/README.md | 9 +- .../commands/speckit.intake-series-create.md | 4 + .../docs/field-validation-summary.md | 2 +- .../man/validate-intake-series-manifest.1 | 2 +- .../docs/man/validate-intake-series-receipt.1 | 2 +- .../intake-sequencing-governance/preset.yml | 2 +- .../templates/intake-series-order-template.md | 7 + .../intake-series-receipt-template.json | 2 +- .../test-intake-sequencing-validator.ps1 | 2 +- .../README.md | 11 +- .../commands/speckit.parallel-autonomous.md | 6 + .../docs/compatibility.md | 14 +- .../docs/getting-started.md | 6 +- .../orchestrate-parallel-autonomous-runs.1 | 2 +- .../preset.yml | 2 +- .../templates/agent-file-addendum.md | 5 + 79 files changed, 427 insertions(+), 182 deletions(-) diff --git a/.agents/skills/speckit-autonomous/SKILL.md b/.agents/skills/speckit-autonomous/SKILL.md index 45d2ad9..44d19b3 100644 --- a/.agents/skills/speckit-autonomous/SKILL.md +++ b/.agents/skills/speckit-autonomous/SKILL.md @@ -19,6 +19,12 @@ $ARGUMENTS Use the request, repository constitution, agent guidance, current feature metadata, and accepted feature artifacts as binding input. +Resolve the project's learner and accessibility policy before Specify. Carry +its declared audience, language order, readability target, first-use +terminology, assumed prior knowledge, and text-first dependency/status/decision +rules through Spec, Plan, Tasks, implementation evidence, documentation, and +retrospective. This preset does not invent a project-specific audience. + Before creating a feature, inspect repository metadata and `specs//autonomous-run-state.json`. A valid `PausedByUser` state MUST stop this command and direct the user to `speckit.autonomous-resume`. A valid diff --git a/.agents/skills/speckit-intake-create/SKILL.md b/.agents/skills/speckit-intake-create/SKILL.md index 4cf2e10..729351f 100644 --- a/.agents/skills/speckit-intake-create/SKILL.md +++ b/.agents/skills/speckit-intake-create/SKILL.md @@ -45,6 +45,10 @@ series. This command never updates or deletes an active intake. It never starts requirements, quality and governance boundaries, dependencies, risks, expected artifacts, evidence, measurable acceptance, assumptions, and open questions. Follow repository language policy and applicable WCAG 2.2 AA. + For learner-facing material, preserve the profile's declared audience, + assumed prior knowledge, first-use terminology rule, and text-first + dependency/status/decision/next-action rule. Never silently assume Spec Kit + experience. 8. Refuse an existing target or active receipt without writing anything. Report `$speckit-intake-update ` as the exact safe command. New targets use provenance mode `New`; Create never claims update authority, diff --git a/.agents/skills/speckit-intake-delete/SKILL.md b/.agents/skills/speckit-intake-delete/SKILL.md index 618caa3..f1a0018 100644 --- a/.agents/skills/speckit-intake-delete/SKILL.md +++ b/.agents/skills/speckit-intake-delete/SKILL.md @@ -16,7 +16,7 @@ metadata: $ARGUMENTS ``` -Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. +Delete is logical and reversible from versioned evidence. v0.2.1 has no purge. 1. Resolve exactly one active intake or one complete series. Require the exact identity, a deletion reason, and explicit current delete authority. diff --git a/.agents/skills/speckit-intake-review/SKILL.md b/.agents/skills/speckit-intake-review/SKILL.md index 630e2f2..5e6d346 100644 --- a/.agents/skills/speckit-intake-review/SKILL.md +++ b/.agents/skills/speckit-intake-review/SKILL.md @@ -26,6 +26,10 @@ exist. Use the installed policy and checklist. measurable acceptance, dependencies, order, security/privacy/A11Y/platform, evidence, delivery authority, risks, references, prompt alignment, and secret or unnecessary-personal-data exposure. + When project policy declares learner-facing material, also verify assumed + prior knowledge, first-use explanations for technical and Spec Kit terms, + the language/readability contract, and text-first dependencies, status, + decisions, and next actions. 3. For a series, additionally review IDs, DAG, gaps, overlap, terminology, invariants, handoffs, future scope, and authority. Use schema 1.1, declare every root, order every target exactly once, and bind the request path and diff --git a/.agents/skills/speckit-intake-series-create/SKILL.md b/.agents/skills/speckit-intake-series-create/SKILL.md index bf29946..aa481b0 100644 --- a/.agents/skills/speckit-intake-series-create/SKILL.md +++ b/.agents/skills/speckit-intake-series-create/SKILL.md @@ -27,6 +27,10 @@ review or feature workflow. completion fact, or delivery authority. 5. Prepare manifest, receipt, operation journal, and learner-readable order document under repository-owned paths. + Preserve the project's declared audience, language order, readability, + first-use terminology, and prior-knowledge boundary. The order document + must state dependencies, blockers, status, decisions, and next actions as + text even when it also contains a diagram. 6. Validate paths, hashes, graph, lifecycle, and receipts in Bash and PowerShell before publishing any active file. 7. Publish all prepared files atomically. A failure leaves an explicit diff --git a/.agents/skills/speckit-parallel-autonomous/SKILL.md b/.agents/skills/speckit-parallel-autonomous/SKILL.md index 6ddab56..99cd17c 100644 --- a/.agents/skills/speckit-parallel-autonomous/SKILL.md +++ b/.agents/skills/speckit-parallel-autonomous/SKILL.md @@ -19,6 +19,12 @@ Require an accepted campaign manifest, local runner-profile binding, explicit delivery authority, and `autonomous-run-governance >= 0.2.2` in every worker repository. +Resolve the shared project learner and accessibility policy before scheduling. +Every worker and the final consolidation must preserve the declared audience, +language order, readability, first-use terminology, prior-knowledge boundary, +and text-first dependency/status/decision/next-action contract. Provider or +runner defaults cannot weaken that policy. + Campaign schemas `1.0`, `1.1`, and `1.2` are supported. Schema `1.2` may declare `intakeReview.required`. When true, validate the result before any worktree or worker process is created. Require one semantic review per unique diff --git a/.claude/skills/speckit-autonomous/SKILL.md b/.claude/skills/speckit-autonomous/SKILL.md index c4bf20a..ad82054 100644 --- a/.claude/skills/speckit-autonomous/SKILL.md +++ b/.claude/skills/speckit-autonomous/SKILL.md @@ -17,6 +17,12 @@ $ARGUMENTS Use the request, repository constitution, agent guidance, current feature metadata, and accepted feature artifacts as binding input. +Resolve the project's learner and accessibility policy before Specify. Carry +its declared audience, language order, readability target, first-use +terminology, assumed prior knowledge, and text-first dependency/status/decision +rules through Spec, Plan, Tasks, implementation evidence, documentation, and +retrospective. This preset does not invent a project-specific audience. + Before creating a feature, inspect repository metadata and `specs//autonomous-run-state.json`. A valid `PausedByUser` state MUST stop this command and direct the user to `speckit.autonomous-resume`. A valid @@ -145,4 +151,4 @@ Finish with task and artifact counts, validation, skipped conditions, review state, follow-ups, remote identifiers when authorized, and exact local/remote synchronization. Set `Completed` only when every applicable schema-1.1 closeout field is terminal and final validation is `Completed`. Do not start the next -feature implicitly. \ No newline at end of file +feature implicitly. diff --git a/.claude/skills/speckit-intake-create/SKILL.md b/.claude/skills/speckit-intake-create/SKILL.md index 0dd78dc..d54f746 100644 --- a/.claude/skills/speckit-intake-create/SKILL.md +++ b/.claude/skills/speckit-intake-create/SKILL.md @@ -43,6 +43,10 @@ series. This command never updates or deletes an active intake. It never starts requirements, quality and governance boundaries, dependencies, risks, expected artifacts, evidence, measurable acceptance, assumptions, and open questions. Follow repository language policy and applicable WCAG 2.2 AA. + For learner-facing material, preserve the profile's declared audience, + assumed prior knowledge, first-use terminology rule, and text-first + dependency/status/decision/next-action rule. Never silently assume Spec Kit + experience. 8. Refuse an existing target or active receipt without writing anything. Report `$speckit-intake-update ` as the exact safe command. New targets use provenance mode `New`; Create never claims update authority, @@ -88,4 +92,4 @@ Finish with status, targets, receipts or series manifest, source count, question and decision counts, delivery authority, validation results, and exactly one next action. For one `ReadyForReview` target, use `$speckit-intake-review `. For a series, use the generated schema-1.1 -Series request. Report the command without executing it. \ No newline at end of file +Series request. Report the command without executing it. diff --git a/.claude/skills/speckit-intake-delete/SKILL.md b/.claude/skills/speckit-intake-delete/SKILL.md index 1502156..aab6c58 100644 --- a/.claude/skills/speckit-intake-delete/SKILL.md +++ b/.claude/skills/speckit-intake-delete/SKILL.md @@ -14,7 +14,7 @@ metadata: $ARGUMENTS ``` -Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. +Delete is logical and reversible from versioned evidence. v0.2.1 has no purge. 1. Resolve exactly one active intake or one complete series. Require the exact identity, a deletion reason, and explicit current delete authority. @@ -40,4 +40,4 @@ Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. Finish with deleted identities, archive and tombstone paths, validation, invalidated references, and exact next action. Never recreate, review, specify, -or start an autonomous command implicitly. \ No newline at end of file +or start an autonomous command implicitly. diff --git a/.claude/skills/speckit-intake-review/SKILL.md b/.claude/skills/speckit-intake-review/SKILL.md index 657830a..74a4a00 100644 --- a/.claude/skills/speckit-intake-review/SKILL.md +++ b/.claude/skills/speckit-intake-review/SKILL.md @@ -24,6 +24,10 @@ exist. Use the installed policy and checklist. measurable acceptance, dependencies, order, security/privacy/A11Y/platform, evidence, delivery authority, risks, references, prompt alignment, and secret or unnecessary-personal-data exposure. + When project policy declares learner-facing material, also verify assumed + prior knowledge, first-use explanations for technical and Spec Kit terms, + the language/readability contract, and text-first dependencies, status, + decisions, and next actions. 3. For a series, additionally review IDs, DAG, gaps, overlap, terminology, invariants, handoffs, future scope, and authority. Use schema 1.1, declare every root, order every target exactly once, and bind the request path and @@ -48,4 +52,4 @@ exist. Use the installed policy and checklist. Finish with outcome, target and worker counts, findings by severity, accepted risks, open questions, result path, and exact next action. Do not start Specify -or an autonomous run implicitly. \ No newline at end of file +or an autonomous run implicitly. diff --git a/.claude/skills/speckit-intake-series-create/SKILL.md b/.claude/skills/speckit-intake-series-create/SKILL.md index d10136f..e4a1384 100644 --- a/.claude/skills/speckit-intake-series-create/SKILL.md +++ b/.claude/skills/speckit-intake-series-create/SKILL.md @@ -25,9 +25,13 @@ review or feature workflow. completion fact, or delivery authority. 5. Prepare manifest, receipt, operation journal, and learner-readable order document under repository-owned paths. + Preserve the project's declared audience, language order, readability, + first-use terminology, and prior-knowledge boundary. The order document + must state dependencies, blockers, status, decisions, and next actions as + text even when it also contains a diagram. 6. Validate paths, hashes, graph, lifecycle, and receipts in Bash and PowerShell before publishing any active file. 7. Publish all prepared files atomically. A failure leaves an explicit incomplete operation and no partially active series. 8. Finish with series ID, cardinalities, validation results, eligible targets, - blockers, and exactly `$speckit-intake-series-status` as the next action. \ No newline at end of file + blockers, and exactly `$speckit-intake-series-status` as the next action. diff --git a/.claude/skills/speckit-parallel-autonomous/SKILL.md b/.claude/skills/speckit-parallel-autonomous/SKILL.md index f417759..537b61a 100644 --- a/.claude/skills/speckit-parallel-autonomous/SKILL.md +++ b/.claude/skills/speckit-parallel-autonomous/SKILL.md @@ -17,6 +17,12 @@ Require an accepted campaign manifest, local runner-profile binding, explicit delivery authority, and `autonomous-run-governance >= 0.2.2` in every worker repository. +Resolve the shared project learner and accessibility policy before scheduling. +Every worker and the final consolidation must preserve the declared audience, +language order, readability, first-use terminology, prior-knowledge boundary, +and text-first dependency/status/decision/next-action contract. Provider or +runner defaults cannot weaken that policy. + Campaign schemas `1.0`, `1.1`, and `1.2` are supported. Schema `1.2` may declare `intakeReview.required`. When true, validate the result before any worktree or worker process is created. Require one semantic review per unique @@ -46,4 +52,4 @@ or incomplete result schedules zero workers. *DE: Worker-spezifische Runner-Profile duerfen das Kampagnenprofil ueberschreiben. Modell und Reasoning nur bei ausdruecklicher Deklaration -anzeigen; keine fremde Agentenkonfiguration erraten.* \ No newline at end of file +anzeigen; keine fremde Agentenkonfiguration erraten.* diff --git a/.github/agents/speckit.autonomous.agent.md b/.github/agents/speckit.autonomous.agent.md index 8a27e7c..21af9de 100644 --- a/.github/agents/speckit.autonomous.agent.md +++ b/.github/agents/speckit.autonomous.agent.md @@ -14,6 +14,12 @@ $ARGUMENTS Use the request, repository constitution, agent guidance, current feature metadata, and accepted feature artifacts as binding input. +Resolve the project's learner and accessibility policy before Specify. Carry +its declared audience, language order, readability target, first-use +terminology, assumed prior knowledge, and text-first dependency/status/decision +rules through Spec, Plan, Tasks, implementation evidence, documentation, and +retrospective. This preset does not invent a project-specific audience. + Before creating a feature, inspect repository metadata and `specs//autonomous-run-state.json`. A valid `PausedByUser` state MUST stop this command and direct the user to `speckit.autonomous-resume`. A valid @@ -142,4 +148,4 @@ Finish with task and artifact counts, validation, skipped conditions, review state, follow-ups, remote identifiers when authorized, and exact local/remote synchronization. Set `Completed` only when every applicable schema-1.1 closeout field is terminal and final validation is `Completed`. Do not start the next -feature implicitly. \ No newline at end of file +feature implicitly. diff --git a/.github/agents/speckit.intake-create.agent.md b/.github/agents/speckit.intake-create.agent.md index ecbe672..5fdb47e 100644 --- a/.github/agents/speckit.intake-create.agent.md +++ b/.github/agents/speckit.intake-create.agent.md @@ -40,6 +40,10 @@ series. This command never updates or deletes an active intake. It never starts requirements, quality and governance boundaries, dependencies, risks, expected artifacts, evidence, measurable acceptance, assumptions, and open questions. Follow repository language policy and applicable WCAG 2.2 AA. + For learner-facing material, preserve the profile's declared audience, + assumed prior knowledge, first-use terminology rule, and text-first + dependency/status/decision/next-action rule. Never silently assume Spec Kit + experience. 8. Refuse an existing target or active receipt without writing anything. Report `$speckit-intake-update ` as the exact safe command. New targets use provenance mode `New`; Create never claims update authority, @@ -85,4 +89,4 @@ Finish with status, targets, receipts or series manifest, source count, question and decision counts, delivery authority, validation results, and exactly one next action. For one `ReadyForReview` target, use `$speckit-intake-review `. For a series, use the generated schema-1.1 -Series request. Report the command without executing it. \ No newline at end of file +Series request. Report the command without executing it. diff --git a/.github/agents/speckit.intake-delete.agent.md b/.github/agents/speckit.intake-delete.agent.md index 652013d..effe5f1 100644 --- a/.github/agents/speckit.intake-delete.agent.md +++ b/.github/agents/speckit.intake-delete.agent.md @@ -11,7 +11,7 @@ description: Logically delete active intake artifacts through archive and tombst $ARGUMENTS ``` -Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. +Delete is logical and reversible from versioned evidence. v0.2.1 has no purge. 1. Resolve exactly one active intake or one complete series. Require the exact identity, a deletion reason, and explicit current delete authority. @@ -37,4 +37,4 @@ Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. Finish with deleted identities, archive and tombstone paths, validation, invalidated references, and exact next action. Never recreate, review, specify, -or start an autonomous command implicitly. \ No newline at end of file +or start an autonomous command implicitly. diff --git a/.github/agents/speckit.intake-review.agent.md b/.github/agents/speckit.intake-review.agent.md index 7c44068..2dd3ab3 100644 --- a/.github/agents/speckit.intake-review.agent.md +++ b/.github/agents/speckit.intake-review.agent.md @@ -21,6 +21,10 @@ exist. Use the installed policy and checklist. measurable acceptance, dependencies, order, security/privacy/A11Y/platform, evidence, delivery authority, risks, references, prompt alignment, and secret or unnecessary-personal-data exposure. + When project policy declares learner-facing material, also verify assumed + prior knowledge, first-use explanations for technical and Spec Kit terms, + the language/readability contract, and text-first dependencies, status, + decisions, and next actions. 3. For a series, additionally review IDs, DAG, gaps, overlap, terminology, invariants, handoffs, future scope, and authority. Use schema 1.1, declare every root, order every target exactly once, and bind the request path and @@ -45,4 +49,4 @@ exist. Use the installed policy and checklist. Finish with outcome, target and worker counts, findings by severity, accepted risks, open questions, result path, and exact next action. Do not start Specify -or an autonomous run implicitly. \ No newline at end of file +or an autonomous run implicitly. diff --git a/.github/agents/speckit.intake-series-create.agent.md b/.github/agents/speckit.intake-series-create.agent.md index 71243d4..7d8c2be 100644 --- a/.github/agents/speckit.intake-series-create.agent.md +++ b/.github/agents/speckit.intake-series-create.agent.md @@ -22,9 +22,13 @@ review or feature workflow. completion fact, or delivery authority. 5. Prepare manifest, receipt, operation journal, and learner-readable order document under repository-owned paths. + Preserve the project's declared audience, language order, readability, + first-use terminology, and prior-knowledge boundary. The order document + must state dependencies, blockers, status, decisions, and next actions as + text even when it also contains a diagram. 6. Validate paths, hashes, graph, lifecycle, and receipts in Bash and PowerShell before publishing any active file. 7. Publish all prepared files atomically. A failure leaves an explicit incomplete operation and no partially active series. 8. Finish with series ID, cardinalities, validation results, eligible targets, - blockers, and exactly `$speckit-intake-series-status` as the next action. \ No newline at end of file + blockers, and exactly `$speckit-intake-series-status` as the next action. diff --git a/.github/agents/speckit.parallel-autonomous.agent.md b/.github/agents/speckit.parallel-autonomous.agent.md index 9280e7a..148bde2 100644 --- a/.github/agents/speckit.parallel-autonomous.agent.md +++ b/.github/agents/speckit.parallel-autonomous.agent.md @@ -14,6 +14,12 @@ Require an accepted campaign manifest, local runner-profile binding, explicit delivery authority, and `autonomous-run-governance >= 0.2.2` in every worker repository. +Resolve the shared project learner and accessibility policy before scheduling. +Every worker and the final consolidation must preserve the declared audience, +language order, readability, first-use terminology, prior-knowledge boundary, +and text-first dependency/status/decision/next-action contract. Provider or +runner defaults cannot weaken that policy. + Campaign schemas `1.0`, `1.1`, and `1.2` are supported. Schema `1.2` may declare `intakeReview.required`. When true, validate the result before any worktree or worker process is created. Require one semantic review per unique @@ -43,4 +49,4 @@ or incomplete result schedules zero workers. *DE: Worker-spezifische Runner-Profile duerfen das Kampagnenprofil ueberschreiben. Modell und Reasoning nur bei ausdruecklicher Deklaration -anzeigen; keine fremde Agentenkonfiguration erraten.* \ No newline at end of file +anzeigen; keine fremde Agentenkonfiguration erraten.* diff --git a/.opencode/command/speckit.autonomous.md b/.opencode/command/speckit.autonomous.md index 8a27e7c..21af9de 100644 --- a/.opencode/command/speckit.autonomous.md +++ b/.opencode/command/speckit.autonomous.md @@ -14,6 +14,12 @@ $ARGUMENTS Use the request, repository constitution, agent guidance, current feature metadata, and accepted feature artifacts as binding input. +Resolve the project's learner and accessibility policy before Specify. Carry +its declared audience, language order, readability target, first-use +terminology, assumed prior knowledge, and text-first dependency/status/decision +rules through Spec, Plan, Tasks, implementation evidence, documentation, and +retrospective. This preset does not invent a project-specific audience. + Before creating a feature, inspect repository metadata and `specs//autonomous-run-state.json`. A valid `PausedByUser` state MUST stop this command and direct the user to `speckit.autonomous-resume`. A valid @@ -142,4 +148,4 @@ Finish with task and artifact counts, validation, skipped conditions, review state, follow-ups, remote identifiers when authorized, and exact local/remote synchronization. Set `Completed` only when every applicable schema-1.1 closeout field is terminal and final validation is `Completed`. Do not start the next -feature implicitly. \ No newline at end of file +feature implicitly. diff --git a/.opencode/command/speckit.intake-create.md b/.opencode/command/speckit.intake-create.md index ecbe672..5fdb47e 100644 --- a/.opencode/command/speckit.intake-create.md +++ b/.opencode/command/speckit.intake-create.md @@ -40,6 +40,10 @@ series. This command never updates or deletes an active intake. It never starts requirements, quality and governance boundaries, dependencies, risks, expected artifacts, evidence, measurable acceptance, assumptions, and open questions. Follow repository language policy and applicable WCAG 2.2 AA. + For learner-facing material, preserve the profile's declared audience, + assumed prior knowledge, first-use terminology rule, and text-first + dependency/status/decision/next-action rule. Never silently assume Spec Kit + experience. 8. Refuse an existing target or active receipt without writing anything. Report `$speckit-intake-update ` as the exact safe command. New targets use provenance mode `New`; Create never claims update authority, @@ -85,4 +89,4 @@ Finish with status, targets, receipts or series manifest, source count, question and decision counts, delivery authority, validation results, and exactly one next action. For one `ReadyForReview` target, use `$speckit-intake-review `. For a series, use the generated schema-1.1 -Series request. Report the command without executing it. \ No newline at end of file +Series request. Report the command without executing it. diff --git a/.opencode/command/speckit.intake-delete.md b/.opencode/command/speckit.intake-delete.md index 652013d..effe5f1 100644 --- a/.opencode/command/speckit.intake-delete.md +++ b/.opencode/command/speckit.intake-delete.md @@ -11,7 +11,7 @@ description: Logically delete active intake artifacts through archive and tombst $ARGUMENTS ``` -Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. +Delete is logical and reversible from versioned evidence. v0.2.1 has no purge. 1. Resolve exactly one active intake or one complete series. Require the exact identity, a deletion reason, and explicit current delete authority. @@ -37,4 +37,4 @@ Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. Finish with deleted identities, archive and tombstone paths, validation, invalidated references, and exact next action. Never recreate, review, specify, -or start an autonomous command implicitly. \ No newline at end of file +or start an autonomous command implicitly. diff --git a/.opencode/command/speckit.intake-review.md b/.opencode/command/speckit.intake-review.md index 7c44068..2dd3ab3 100644 --- a/.opencode/command/speckit.intake-review.md +++ b/.opencode/command/speckit.intake-review.md @@ -21,6 +21,10 @@ exist. Use the installed policy and checklist. measurable acceptance, dependencies, order, security/privacy/A11Y/platform, evidence, delivery authority, risks, references, prompt alignment, and secret or unnecessary-personal-data exposure. + When project policy declares learner-facing material, also verify assumed + prior knowledge, first-use explanations for technical and Spec Kit terms, + the language/readability contract, and text-first dependencies, status, + decisions, and next actions. 3. For a series, additionally review IDs, DAG, gaps, overlap, terminology, invariants, handoffs, future scope, and authority. Use schema 1.1, declare every root, order every target exactly once, and bind the request path and @@ -45,4 +49,4 @@ exist. Use the installed policy and checklist. Finish with outcome, target and worker counts, findings by severity, accepted risks, open questions, result path, and exact next action. Do not start Specify -or an autonomous run implicitly. \ No newline at end of file +or an autonomous run implicitly. diff --git a/.opencode/command/speckit.intake-series-create.md b/.opencode/command/speckit.intake-series-create.md index 71243d4..7d8c2be 100644 --- a/.opencode/command/speckit.intake-series-create.md +++ b/.opencode/command/speckit.intake-series-create.md @@ -22,9 +22,13 @@ review or feature workflow. completion fact, or delivery authority. 5. Prepare manifest, receipt, operation journal, and learner-readable order document under repository-owned paths. + Preserve the project's declared audience, language order, readability, + first-use terminology, and prior-knowledge boundary. The order document + must state dependencies, blockers, status, decisions, and next actions as + text even when it also contains a diagram. 6. Validate paths, hashes, graph, lifecycle, and receipts in Bash and PowerShell before publishing any active file. 7. Publish all prepared files atomically. A failure leaves an explicit incomplete operation and no partially active series. 8. Finish with series ID, cardinalities, validation results, eligible targets, - blockers, and exactly `$speckit-intake-series-status` as the next action. \ No newline at end of file + blockers, and exactly `$speckit-intake-series-status` as the next action. diff --git a/.opencode/command/speckit.parallel-autonomous.md b/.opencode/command/speckit.parallel-autonomous.md index 9280e7a..148bde2 100644 --- a/.opencode/command/speckit.parallel-autonomous.md +++ b/.opencode/command/speckit.parallel-autonomous.md @@ -14,6 +14,12 @@ Require an accepted campaign manifest, local runner-profile binding, explicit delivery authority, and `autonomous-run-governance >= 0.2.2` in every worker repository. +Resolve the shared project learner and accessibility policy before scheduling. +Every worker and the final consolidation must preserve the declared audience, +language order, readability, first-use terminology, prior-knowledge boundary, +and text-first dependency/status/decision/next-action contract. Provider or +runner defaults cannot weaken that policy. + Campaign schemas `1.0`, `1.1`, and `1.2` are supported. Schema `1.2` may declare `intakeReview.required`. When true, validate the result before any worktree or worker process is created. Require one semantic review per unique @@ -43,4 +49,4 @@ or incomplete result schedules zero workers. *DE: Worker-spezifische Runner-Profile duerfen das Kampagnenprofil ueberschreiben. Modell und Reasoning nur bei ausdruecklicher Deklaration -anzeigen; keine fremde Agentenkonfiguration erraten.* \ No newline at end of file +anzeigen; keine fremde Agentenkonfiguration erraten.* diff --git a/.specify/presets/.registry b/.specify/presets/.registry index ad8ac15..a2563d8 100644 --- a/.specify/presets/.registry +++ b/.specify/presets/.registry @@ -44,7 +44,7 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:08:58.572355+00:00" + "installed_at": "2026-07-25T16:29:41.950131+00:00" }, "architecture-governance": { "version": "0.5.1", @@ -89,7 +89,7 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:09:00.121752+00:00" + "installed_at": "2026-07-25T16:29:43.510549+00:00" }, "isaqb-architecture-governance": { "version": "0.2.1", @@ -134,12 +134,12 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:09:01.690466+00:00" + "installed_at": "2026-07-25T16:29:45.030355+00:00" }, "a11y-governance": { - "version": "0.4.1", + "version": "0.4.2", "source": "local", - "manifest_hash": "sha256:7d6610d93fb9fe6fc455daf5280fb12871d5161f1c3282ca336961369a1b9b04", + "manifest_hash": "sha256:111d68779fbb3e36cb1548176ae142a331e950777ed262c54dc7162b7aa8edd2", "enabled": true, "priority": 40, "registered_commands": { @@ -179,7 +179,7 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:09:03.245499+00:00" + "installed_at": "2026-07-25T16:29:46.564478+00:00" }, "cross-platform-governance": { "version": "0.2.1", @@ -224,12 +224,12 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:09:04.787724+00:00" + "installed_at": "2026-07-25T16:29:48.101448+00:00" }, "agent-parity-governance": { - "version": "0.4.0", + "version": "0.4.1", "source": "local", - "manifest_hash": "sha256:04f14ede9357a62da3e0371429a48817d9f3224615603b67ecb5669f9cd2e36a", + "manifest_hash": "sha256:991a42a55a97e51896828d4d885070f16c1967ba87d7ee38ec8c43169d48a530", "enabled": true, "priority": 60, "registered_commands": { @@ -269,12 +269,12 @@ "speckit-plan", "speckit-tasks" ], - "installed_at": "2026-07-24T15:09:06.654598+00:00" + "installed_at": "2026-07-25T16:29:49.627613+00:00" }, "intake-authoring-governance": { - "version": "0.2.0", + "version": "0.2.1", "source": "local", - "manifest_hash": "sha256:a9503c64e8c812b4b51374ec53ac195dc19b408a59601eb8053e73097ee93790", + "manifest_hash": "sha256:10ece00e62a26dfbf7ffad629ac38b09d95c8cbde3eb0e7e91d49dc553ed3e20", "enabled": true, "priority": 64, "registered_commands": { @@ -328,12 +328,12 @@ "speckit-intake-delete", "speckit-intake-create-status" ], - "installed_at": "2026-07-24T15:09:08.212833+00:00" + "installed_at": "2026-07-25T16:29:51.631075+00:00" }, "intake-review-governance": { - "version": "0.1.1", + "version": "0.1.2", "source": "local", - "manifest_hash": "sha256:b85a75202be58d1f17b0450124beb5a1f941dfab6828e436ed0e382c8fcb7cd2", + "manifest_hash": "sha256:b71870842ff3b397bd0fe40fb24f714e29d6a4dc946883b709e0a9b5f0329da4", "enabled": true, "priority": 65, "registered_commands": { @@ -373,12 +373,78 @@ "speckit-intake-repair", "speckit-intake-review-status" ], - "installed_at": "2026-07-24T15:09:09.691463+00:00" + "installed_at": "2026-07-25T16:29:53.109671+00:00" + }, + "intake-sequencing-governance": { + "version": "0.1.1", + "source": "local", + "manifest_hash": "sha256:3c7a0eadff06485be7fca100156ad08a168dbe5795d3f09d182d54aa995e1c72", + "enabled": true, + "priority": 66, + "registered_commands": { + "agy": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ], + "claude": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ], + "codex": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ], + "copilot": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ], + "opencode": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ], + "zed": [ + "speckit.intake-series-create", + "speckit.intake-series-read", + "speckit.intake-series-update", + "speckit.intake-series-delete", + "speckit.intake-series-status", + "speckit.intake-series-next" + ] + }, + "registered_skills": [ + "speckit-intake-series-create", + "speckit-intake-series-read", + "speckit-intake-series-update", + "speckit-intake-series-delete", + "speckit-intake-series-status", + "speckit-intake-series-next" + ], + "installed_at": "2026-07-25T16:29:54.602897+00:00" }, "autonomous-run-governance": { - "version": "0.3.2", + "version": "0.3.3", "source": "local", - "manifest_hash": "sha256:738af513e3e4c4345d2d3f7061e24d6d9a670d3b8546c254e5afe4ea2196b410", + "manifest_hash": "sha256:9cc9b4f7836be65b1ccd20a0c9be41d4ae9073b609d63b112ee61ba5ab747e4d", "enabled": true, "priority": 70, "registered_commands": { @@ -432,12 +498,12 @@ "speckit-autonomous-stop", "speckit-autonomous-resume" ], - "installed_at": "2026-07-24T15:09:11.227638+00:00" + "installed_at": "2026-07-25T16:29:56.164941+00:00" }, "parallel-autonomous-run-governance": { - "version": "0.2.3", + "version": "0.2.4", "source": "local", - "manifest_hash": "sha256:c06d28abc580458ddd69b33023f2a45951d59ca1f31305cc6b1d03299e5f3509", + "manifest_hash": "sha256:9c6c0895797e601a8227d4a8ff923709c6ab7135a33791545ab8555eadfda2bb", "enabled": true, "priority": 80, "registered_commands": { @@ -491,73 +557,7 @@ "speckit-parallel-autonomous-resume", "speckit-parallel-autonomous-consolidate" ], - "installed_at": "2026-07-24T15:09:12.791306+00:00" - }, - "intake-sequencing-governance": { - "version": "0.1.0", - "source": "local", - "manifest_hash": "sha256:ae332ef9e3976df78fce1a859d2e39463dd06c069b99333968566bb50abd0390", - "enabled": true, - "priority": 66, - "registered_commands": { - "agy": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ], - "claude": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ], - "codex": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ], - "copilot": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ], - "opencode": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ], - "zed": [ - "speckit.intake-series-create", - "speckit.intake-series-read", - "speckit.intake-series-update", - "speckit.intake-series-delete", - "speckit.intake-series-status", - "speckit.intake-series-next" - ] - }, - "registered_skills": [ - "speckit-intake-series-create", - "speckit-intake-series-read", - "speckit-intake-series-update", - "speckit-intake-series-delete", - "speckit-intake-series-status", - "speckit-intake-series-next" - ], - "installed_at": "2026-07-25T14:24:00.640016+00:00" + "installed_at": "2026-07-25T16:29:57.735045+00:00" } } } \ No newline at end of file diff --git a/.specify/presets/a11y-governance/README.md b/.specify/presets/a11y-governance/README.md index 0ae2c86..689400b 100644 --- a/.specify/presets/a11y-governance/README.md +++ b/.specify/presets/a11y-governance/README.md @@ -1,11 +1,21 @@ # A11Y Governance Preset -Version: `0.4.1` +Version: `0.4.2` Status: published, standard governance preset Priority: `40` Requires: Spec-Kit `>=0.8.0` (uses the `wrap` and `append` composition strategies introduced in `0.8.x`). +Version `0.4.2` ergänzt einen portablen Zielgruppenvertrag: Das Projekt +deklariert Zielgruppe und Vorwissen. Lernmaterial erklärt Fach- und +Spec-Kit-Begriffe beim ersten Auftreten und stellt Abhängigkeiten, Status, +Entscheidungen und nächste Schritte immer auch als geordneten Text bereit. + +*Version `0.4.2` adds a portable audience contract: the project declares its +audience and assumed prior knowledge. Learning material explains domain and +Spec Kit terms on first use and always provides dependencies, status, +decisions, and next actions as ordered text.* + ## Zweck / Purpose Dieses Standard-Preset bringt Barrierefreiheit, DE-first/EN-second @@ -89,7 +99,7 @@ location, and known target audiences, artifact types, and language level.* ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-a11y-governance/archive/refs/tags/v0.4.1.zip \ + --from https://github.com/hindermath/spec-kit-preset-a11y-governance/archive/refs/tags/v0.4.2.zip \ --priority 40 specify preset info a11y-governance ``` @@ -232,6 +242,8 @@ Trade-offs sonst schwer verständlich bleiben. ## Versionshinweise / Release Notes +- `v0.4.2` adds the project-declared audience, prior-knowledge, first-use + terminology, and text-first information contract. - `v0.4.1` adds accessible text/JSON status parity, stable labelled ordering, and understandable repeated status/resume output. - `v0.4.0` adds audit-ready Spec-Kit run evidence fields so generated Markdown diff --git a/.specify/presets/a11y-governance/preset.yml b/.specify/presets/a11y-governance/preset.yml index 82ab727..56e32f0 100644 --- a/.specify/presets/a11y-governance/preset.yml +++ b/.specify/presets/a11y-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "a11y-governance" name: "A11Y Governance" - version: "0.4.1" + version: "0.4.2" description: "Adds accessibility (WCAG 2.2 AA), accessible text and JSON status parity, bilingual DE/EN delivery, CEFR-B2 readability, inclusive-content governance, didactic inline-code-comment review, and audit-ready Spec-Kit run evidence to Spec Kit." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-a11y-governance" diff --git a/.specify/presets/a11y-governance/templates/agent-file-addendum.md b/.specify/presets/a11y-governance/templates/agent-file-addendum.md index e1669d9..c84041a 100644 --- a/.specify/presets/a11y-governance/templates/agent-file-addendum.md +++ b/.specify/presets/a11y-governance/templates/agent-file-addendum.md @@ -15,6 +15,11 @@ - Aim for CEFR Level B2 in user-facing prose. Define domain terms on first use. Add a short DE/EN explanation under every ASCII diagram, meaningful table, or graphic. +- Read the project's declared audience before producing learner-facing + material. Do not assume prior Spec Kit knowledge unless the project + explicitly declares it. Explain workflow terms at first use, and keep + dependencies, status, decisions, and next actions available as ordered text + rather than only as a visual. - Review new or changed non-trivial logic for didactic inline-code-comment value when learning comprehension or maintainability is affected. - Good didactic comments explain the `why`, trade-off, boundary condition, diff --git a/.specify/presets/a11y-governance/templates/constitution-addendum.md b/.specify/presets/a11y-governance/templates/constitution-addendum.md index 70117d1..f6dde05 100644 --- a/.specify/presets/a11y-governance/templates/constitution-addendum.md +++ b/.specify/presets/a11y-governance/templates/constitution-addendum.md @@ -40,6 +40,12 @@ - Add a short CEFR-B2 explanation in German first and English second below every ASCII diagram, table that needs interpretation, or graphic that conveys meaning. +- Each project MUST declare the audience and assumed prior knowledge for + learner-facing material. A project that targets first-time Spec Kit users + MUST define Spec Kit and workflow-specific terms at first use. +- Dependency, status, decision, and next-action information MUST remain + understandable as ordered text. Diagrams may support that text, but cannot + be the only source of meaning. ### Didactic inline-code comments diff --git a/.specify/presets/a11y-governance/templates/plan-addendum.md b/.specify/presets/a11y-governance/templates/plan-addendum.md index bd57ec5..f68a4fb 100644 --- a/.specify/presets/a11y-governance/templates/plan-addendum.md +++ b/.specify/presets/a11y-governance/templates/plan-addendum.md @@ -8,6 +8,10 @@ is added or changed; plan whether headings will use the inline `DE / EN` pattern or a synchronised `*.EN.md` companion document. - Plan a `CEFR Level B2` readability pass on user-facing prose. +- Plan a check against the project's declared audience and prior-knowledge + boundary. Define technical and Spec Kit terms on first use where needed. +- Plan a text-first review for dependency, status, decision, and next-action + information; a diagram is supporting evidence, not the sole explanation. - Plan checks for German orthographic correctness (umlauts and `ß`); no ASCII fallbacks. - Plan code-block language tagging audit (` ```text ` for ASCII art / diff --git a/.specify/presets/a11y-governance/templates/spec-addendum.md b/.specify/presets/a11y-governance/templates/spec-addendum.md index 0299560..9f8cd82 100644 --- a/.specify/presets/a11y-governance/templates/spec-addendum.md +++ b/.specify/presets/a11y-governance/templates/spec-addendum.md @@ -10,6 +10,10 @@ pattern or use a `*.EN.md` companion document. - Record the readability target — default `CEFR Level B2` for user-facing prose, with domain terms defined on first use. +- Record the declared audience, its assumed prior knowledge, and whether + first-time Spec Kit users are included. +- Record how dependencies, status, decisions, and next actions remain + available without relying only on a diagram, colour, or visual position. - Record whether code blocks, ASCII diagrams, or images need explicit language tags, alt text, or short DE/EN explanations beneath them. - Record whether the feature adds or changes non-trivial code logic. diff --git a/.specify/presets/a11y-governance/templates/tasks-addendum.md b/.specify/presets/a11y-governance/templates/tasks-addendum.md index acbcddf..316cb5f 100644 --- a/.specify/presets/a11y-governance/templates/tasks-addendum.md +++ b/.specify/presets/a11y-governance/templates/tasks-addendum.md @@ -7,6 +7,10 @@ `*.EN.md` companion document. - Add CEFR-B2 readability review tasks for user-facing prose; ensure each domain term is defined on first use. +- Add tasks that verify the declared audience and prior-knowledge boundary, + including first-use explanations for Spec Kit workflow terms. +- Add a text-first check for dependencies, status, decisions, and next + actions so no acceptance evidence depends only on a visual. - Add a German orthographic correctness check (umlauts and `ß`; no ASCII fallbacks). - Add CLI accessibility review tasks for terminal-facing output (text diff --git a/.specify/presets/agent-parity-governance/README.md b/.specify/presets/agent-parity-governance/README.md index ffa1680..89fb654 100644 --- a/.specify/presets/agent-parity-governance/README.md +++ b/.specify/presets/agent-parity-governance/README.md @@ -1,11 +1,22 @@ # Agent Parity Governance Preset -Version: `0.4.0` +Version: `0.4.1` Status: published, standard governance preset Priority: `60` Requires: Spec-Kit `>=0.8.0` (uses the `wrap` and `append` composition strategies introduced in `0.8.x`). +Version `0.4.1` behandelt einen projektspezifischen Lernenden- und +Barrierefreiheitsvertrag als gemeinsame Regel. Zielgruppe, Vorwissen, +Sprachreihenfolge, Lesbarkeit, Begriffserklärungen und textorientierte +Informationswege müssen auf allen gepflegten Agenten- und Template-Flächen +semantisch gleich bleiben. + +*Version `0.4.1` treats a project-specific learner and accessibility contract +as shared guidance. Audience, prior knowledge, language order, readability, +term explanations, and text-first information paths must remain semantically +equivalent across maintained agent and template surfaces.* + ## Zweck / Purpose Dieses Standard-Preset verhindert stillen Drift zwischen KI-Agenten-Dateien. @@ -91,7 +102,7 @@ shared and which are intentionally agent-specific.* ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-agent-parity-governance/archive/refs/tags/v0.4.0.zip \ + --from https://github.com/hindermath/spec-kit-preset-agent-parity-governance/archive/refs/tags/v0.4.1.zip \ --priority 60 specify preset info agent-parity-governance ``` @@ -238,6 +249,14 @@ Abweichungen ausdrücklich in derselben Änderung. - Installation does not grant repository, remote, merge, bypass, deployment, cancellation, secret, or provider-administration authority. +## Version 0.4.1 / Version 0.4.1 + +`v0.4.1` ergänzt die semantische Parität für projektdeklarierte Lernenden- und +Barrierefreiheitsverträge. + +*`v0.4.1` adds semantic parity for project-declared learner and accessibility +contracts.* + ## Version 0.4.0 / Version 0.4.0 `v0.4.0` ergänzt Flottenabschluss-Nachweise über alle Repository-Ebenen, diff --git a/.specify/presets/agent-parity-governance/preset.yml b/.specify/presets/agent-parity-governance/preset.yml index 892246a..85c1dde 100644 --- a/.specify/presets/agent-parity-governance/preset.yml +++ b/.specify/presets/agent-parity-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "agent-parity-governance" name: "Agent Parity Governance" - version: "0.4.0" + version: "0.4.1" description: "Adds shared-guidance and generated-command parity, repository-fleet completion evidence, secret-free runner/status metadata, audit-ready Spec-Kit run evidence, and agent-neutral model-routing guidance across declared AI-agent surfaces." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-agent-parity-governance" diff --git a/.specify/presets/agent-parity-governance/templates/agent-file-addendum.md b/.specify/presets/agent-parity-governance/templates/agent-file-addendum.md index 2a05e60..53aac9c 100644 --- a/.specify/presets/agent-parity-governance/templates/agent-file-addendum.md +++ b/.specify/presets/agent-parity-governance/templates/agent-file-addendum.md @@ -53,6 +53,11 @@ changelogs, archived feature evidence, and compatibility aliases. - Validate equivalent command meaning across generated skills, prompts, commands, and instruction files; matching filenames alone are insufficient. +- When project policy declares learner audiences, language order, readability, + first-use terminology, prior-knowledge limits, or text-first accessibility, + propagate that complete policy across every maintained agent surface and + repository-owned Spec Kit template. Do not reduce it to an agent-specific + summary. ## Runner and Status Metadata diff --git a/.specify/presets/agent-parity-governance/templates/agent-parity-checklist-template.md b/.specify/presets/agent-parity-governance/templates/agent-parity-checklist-template.md index 8e44bbf..5228d4c 100644 --- a/.specify/presets/agent-parity-governance/templates/agent-parity-checklist-template.md +++ b/.specify/presets/agent-parity-governance/templates/agent-parity-checklist-template.md @@ -77,6 +77,8 @@ confirm whether the shared rule landed. - Diffs across all surfaces compared side-by-side: - Bilingual delivery preserved (DE first, EN second) where applicable: +- Declared audience, prior knowledge, CEFR target, first-use terminology, and + text-first accessibility are equivalent across all maintained surfaces: - Wording consistent (no contradictory directives): - Cross-references valid (paths, anchor links, file names): diff --git a/.specify/presets/autonomous-run-governance/README.md b/.specify/presets/autonomous-run-governance/README.md index 6cf6cc7..48f7847 100644 --- a/.specify/presets/autonomous-run-governance/README.md +++ b/.specify/presets/autonomous-run-governance/README.md @@ -3,11 +3,16 @@ Permission-bounded, evidence-first governance for one explicitly delegated autonomous Spec Kit run. -Version `0.3.2` | Priority `70` | Spec Kit `>=0.8.3` +Version `0.3.3` | Priority `70` | Spec Kit `>=0.8.3` -Version 0.3.2 recognizes optional `intake-review-governance`. Preset 9 remains +Version 0.3.3 recognizes optional `intake-review-governance`. Preset 9 remains `N/A` unless repository policy explicitly activates the gate. +Version 0.3.3 additionally carries the accepted project-specific learner and +accessibility contract through Specify, Plan, Tasks, implementation evidence, +documentation, and retrospective. It does not invent a target audience or +silently assume Spec Kit experience. + ## Deutsch ### Wofuer ist dieses Preset gedacht? @@ -60,7 +65,7 @@ have succeeded. ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ + --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.3.zip \ --priority 70 ``` @@ -133,7 +138,7 @@ bypass, secret, or provider-administration authority. ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ + --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.3.zip \ --priority 70 ``` diff --git a/.specify/presets/autonomous-run-governance/commands/speckit.autonomous.md b/.specify/presets/autonomous-run-governance/commands/speckit.autonomous.md index 5091ffc..d8cf189 100644 --- a/.specify/presets/autonomous-run-governance/commands/speckit.autonomous.md +++ b/.specify/presets/autonomous-run-governance/commands/speckit.autonomous.md @@ -11,6 +11,12 @@ $ARGUMENTS Use the request, repository constitution, agent guidance, current feature metadata, and accepted feature artifacts as binding input. +Resolve the project's learner and accessibility policy before Specify. Carry +its declared audience, language order, readability target, first-use +terminology, assumed prior knowledge, and text-first dependency/status/decision +rules through Spec, Plan, Tasks, implementation evidence, documentation, and +retrospective. This preset does not invent a project-specific audience. + Before creating a feature, inspect repository metadata and `specs//autonomous-run-state.json`. A valid `PausedByUser` state MUST stop this command and direct the user to `speckit.autonomous-resume`. A valid diff --git a/.specify/presets/autonomous-run-governance/docs/compatibility.md b/.specify/presets/autonomous-run-governance/docs/compatibility.md index e2011f7..f13928c 100644 --- a/.specify/presets/autonomous-run-governance/docs/compatibility.md +++ b/.specify/presets/autonomous-run-governance/docs/compatibility.md @@ -8,7 +8,7 @@ | Ebene | Aktueller Wert | Bedeutung | |---|---|---| -| Preset-Release | `v0.3.2` | Veroeffentlichtes Paket und ZIP | +| Preset-Release | `v0.3.3` | Veroeffentlichtes Paket und ZIP | | `preset.yml`-Schema | `schema_version: "1.0"` | Spec-Kit-Presetmanifest | | Run-State-Vertrag | `schemaVersion: "1.1"` | Autonomer Lifecycle und Closeout | @@ -16,9 +16,9 @@ Diese Werte duerfen nicht miteinander verwechselt werden. Ein Presetmanifest-Schema `1.0` bedeutet nicht, dass der Run-State ebenfalls Schema `1.0` verwendet. -### Upgrade auf `v0.3.2` +### Upgrade auf `v0.3.3` -`v0.3.2` ergaenzt das optionale, policy-gesteuerte Intake-Review-Gate vor der +`v0.3.3` ergaenzt das optionale, policy-gesteuerte Intake-Review-Gate vor der Feature-Erstellung. Ohne Preset 9 oder aktive Policy bleibt das Ergebnis `N/A` und das bisherige Verhalten unveraendert. @@ -38,7 +38,7 @@ den No-Delta-Befund. `parallel-autonomous-run-governance` benoetigt in jedem realen Worker-Repository mindestens Preset 7 `v0.2.2`. Die gemeinsam getestete -aktuelle Kombination ist Preset 7 `v0.3.2` mit Preset 8 `v0.2.3`. +aktuelle Kombination ist Preset 7 `v0.3.3` mit Preset 8 `v0.2.3`. ## English @@ -46,16 +46,16 @@ aktuelle Kombination ist Preset 7 `v0.3.2` mit Preset 8 `v0.2.3`. | Layer | Current value | Meaning | |---|---|---| -| Preset release | `v0.3.2` | Published package and ZIP | +| Preset release | `v0.3.3` | Published package and ZIP | | `preset.yml` schema | `schema_version: "1.0"` | Spec Kit preset manifest | | Run-state contract | `schemaVersion: "1.1"` | Autonomous lifecycle and closeout | Do not confuse these values. Preset-manifest schema `1.0` does not imply run-state schema `1.0`. -### Upgrade to `v0.3.2` +### Upgrade to `v0.3.3` -`v0.3.2` adds the optional policy-driven intake-review gate before feature +`v0.3.3` adds the optional policy-driven intake-review gate before feature creation. Without Preset 9 or an active policy, the result is `N/A` and prior behavior remains unchanged. @@ -67,5 +67,5 @@ result. ### Relationship with Preset 8 `parallel-autonomous-run-governance` requires at least Preset 7 `v0.2.2` in -every real worker repository. The currently tested pair is Preset 7 `v0.3.2` +every real worker repository. The currently tested pair is Preset 7 `v0.3.3` with Preset 8 `v0.2.3`. diff --git a/.specify/presets/autonomous-run-governance/docs/getting-started.md b/.specify/presets/autonomous-run-governance/docs/getting-started.md index a9b9c67..ed8d2fc 100644 --- a/.specify/presets/autonomous-run-governance/docs/getting-started.md +++ b/.specify/presets/autonomous-run-governance/docs/getting-started.md @@ -11,7 +11,7 @@ Vor dem ersten Lauf muessen folgende Bedingungen erfuellt sein: 1. Das Ziel ist ein Git-Repository mit akzeptierten Spec-Kit-Artefakten oder einer eindeutig beschriebenen neuen Feature-Anforderung. 2. Spec Kit `>=0.8.3` ist installiert. -3. `autonomous-run-governance >=0.3.2` ist aktiv. +3. `autonomous-run-governance >=0.3.3` ist aktiv. 4. Constitution und Agent-Guidance sind lesbar. 5. Der Arbeitsbaum ist bekannt; fremde Aenderungen sind abgegrenzt. 6. Delivery-Modus und erlaubte Remote-Aktionen sind ausdruecklich genannt. @@ -22,7 +22,7 @@ Veröffentlichter Tag: ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ + --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.3.zip \ --priority 70 ``` @@ -41,7 +41,7 @@ specify preset resolve autonomous-run-state-template specify preset resolve autonomous-run-readiness-checklist-template ``` -Erwartet werden Version `0.3.2`, Prioritaet `70` und genau ein Beitrag je +Erwartet werden Version `0.3.3`, Prioritaet `70` und genau ein Beitrag je autonomem Befehl. ### Readiness vor dem Start @@ -100,7 +100,7 @@ Before the first run: 1. The target is a Git repository with accepted Spec Kit artifacts or a clearly described new feature request. 2. Spec Kit `>=0.8.3` is installed. -3. `autonomous-run-governance >=0.3.2` is active. +3. `autonomous-run-governance >=0.3.3` is active. 4. The constitution and agent guidance are readable. 5. Worktree ownership and unrelated changes are known. 6. Delivery mode and permitted remote actions are explicit. @@ -111,7 +111,7 @@ Published tag: ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ + --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.3.zip \ --priority 70 ``` @@ -130,7 +130,7 @@ specify preset resolve autonomous-run-state-template specify preset resolve autonomous-run-readiness-checklist-template ``` -Expect version `0.3.2`, priority `70`, and one contribution for each autonomous +Expect version `0.3.3`, priority `70`, and one contribution for each autonomous command. ### Readiness questions diff --git a/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-gate-evidence.1 b/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-gate-evidence.1 index 93bebf3..7f1948e 100644 --- a/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-gate-evidence.1 +++ b/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-gate-evidence.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-AUTONOMOUS-GATE-EVIDENCE 1 "2026-07-21" "autonomous-run-governance 0.3.2" "User Commands" +.TH VALIDATE-AUTONOMOUS-GATE-EVIDENCE 1 "2026-07-21" "autonomous-run-governance 0.3.3" "User Commands" .SH NAME validate-autonomous-gate-evidence \- validate exact-head delivery gates .SH SYNOPSIS diff --git a/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-run-state.1 b/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-run-state.1 index a2f7766..21362cb 100644 --- a/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-run-state.1 +++ b/.specify/presets/autonomous-run-governance/docs/man/validate-autonomous-run-state.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-AUTONOMOUS-RUN-STATE 1 "2026-07-21" "autonomous-run-governance 0.3.2" "User Commands" +.TH VALIDATE-AUTONOMOUS-RUN-STATE 1 "2026-07-21" "autonomous-run-governance 0.3.3" "User Commands" .SH NAME validate-autonomous-run-state \- validate resumable autonomous Spec Kit run state .SH SYNOPSIS diff --git a/.specify/presets/autonomous-run-governance/preset.yml b/.specify/presets/autonomous-run-governance/preset.yml index 79d5c4b..fbb21a4 100644 --- a/.specify/presets/autonomous-run-governance/preset.yml +++ b/.specify/presets/autonomous-run-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "autonomous-run-governance" name: "Autonomous Run Governance" - version: "0.3.2" + version: "0.3.3" description: "Adds permission-bounded autonomous delivery and an optional policy-driven intake-review gate before feature creation." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-autonomous-run-governance" diff --git a/.specify/presets/autonomous-run-governance/templates/agent-file-addendum.md b/.specify/presets/autonomous-run-governance/templates/agent-file-addendum.md index b9dbb57..dc47b6c 100644 --- a/.specify/presets/autonomous-run-governance/templates/agent-file-addendum.md +++ b/.specify/presets/autonomous-run-governance/templates/agent-file-addendum.md @@ -54,3 +54,9 @@ and checklists. Minimally add an applicable missing rule and rerun Analyze; preserve scope and do not rewrite accepted artifacts for efficiency-only guidance. +- Before Specify and again before implementation, read the accepted project's + learner and accessibility policy. Preserve its declared audience, language + order, CEFR target, first-use terminology, prior-knowledge boundary, and + text-first dependency/status/decision rules in Spec, Plan, Tasks, evidence, + documentation, and retrospective. Installation of this preset does not + invent a project-specific audience. diff --git a/.specify/presets/intake-authoring-governance/README.md b/.specify/presets/intake-authoring-governance/README.md index 05666b3..2b73ba0 100644 --- a/.specify/presets/intake-authoring-governance/README.md +++ b/.specify/presets/intake-authoring-governance/README.md @@ -1,11 +1,16 @@ # Intake Authoring Governance Preset Optional, stackable intake-authoring governance for GitHub Spec Kit. Version -`0.2.0` governs traceable intake Create, Read, Update, logical Delete, bounded +`0.2.1` governs traceable intake Create, Read, Update, logical Delete, bounded public HTTPS sources, and explicitly approved intake series. +Version `0.2.1` carries a project-profile learner contract into new or updated +intakes: declared audience, assumed prior knowledge, first-use terminology, and +text-first dependencies, status, decisions, and next actions. It does not +hard-code a country, occupation, or language into the portable preset. + *Optional, stackable intake-authoring governance for GitHub Spec Kit. Version -`0.2.0` governs traceable intake Create, Read, Update, logical Delete, bounded +`0.2.1` governs traceable intake Create, Read, Update, logical Delete, bounded public HTTPS sources, and explicitly approved intake series.* Recommended priority: `64`, after Agent Parity (`60`) and before Intake Review @@ -37,7 +42,7 @@ push, pull request, or merge. - `$speckit-intake-update`: aktualisiert ausdrücklich einen aktiven Intake oder migriert eine freigegebene Serie. - `$speckit-intake-delete`: archiviert aktive Artefakte und erzeugt einen - Tombstone; v0.2.0 besitzt keinen Purge. + Tombstone; v0.2.1 besitzt keinen Purge. - `$speckit-intake-create-status`: prueft Receipt, Ziel, lokale Quellen und Prompt-Zustand read-only. @@ -49,7 +54,7 @@ and freshness without writing.* ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-intake-authoring-governance/archive/refs/tags/v0.2.0.zip \ + --from https://github.com/hindermath/spec-kit-preset-intake-authoring-governance/archive/refs/tags/v0.2.1.zip \ --priority 64 specify preset list specify preset info intake-authoring-governance @@ -183,7 +188,7 @@ Lösch-Evidence gespeichert. Historie, Archive und Tombstones werden nie gepurgt. *Delete is logical. It archives target and receipt byte-for-byte before -removing active files and writes a validated tombstone. v0.2.0 has no purge.* +removing active files and writes a validated tombstone. v0.2.1 has no purge.* ### Legacy adoption / Uebernahme bestehender Intakes diff --git a/.specify/presets/intake-authoring-governance/commands/speckit.intake-create.md b/.specify/presets/intake-authoring-governance/commands/speckit.intake-create.md index 6aeb774..38107f6 100644 --- a/.specify/presets/intake-authoring-governance/commands/speckit.intake-create.md +++ b/.specify/presets/intake-authoring-governance/commands/speckit.intake-create.md @@ -38,6 +38,10 @@ series. This command never updates or deletes an active intake. It never starts requirements, quality and governance boundaries, dependencies, risks, expected artifacts, evidence, measurable acceptance, assumptions, and open questions. Follow repository language policy and applicable WCAG 2.2 AA. + For learner-facing material, preserve the profile's declared audience, + assumed prior knowledge, first-use terminology rule, and text-first + dependency/status/decision/next-action rule. Never silently assume Spec Kit + experience. 8. Refuse an existing target or active receipt without writing anything. Report `$speckit-intake-update ` as the exact safe command. New targets use provenance mode `New`; Create never claims update authority, diff --git a/.specify/presets/intake-authoring-governance/commands/speckit.intake-delete.md b/.specify/presets/intake-authoring-governance/commands/speckit.intake-delete.md index 14fc7f0..192d1fc 100644 --- a/.specify/presets/intake-authoring-governance/commands/speckit.intake-delete.md +++ b/.specify/presets/intake-authoring-governance/commands/speckit.intake-delete.md @@ -8,7 +8,7 @@ description: Logically delete active intake artifacts through archive and tombst $ARGUMENTS ``` -Delete is logical and reversible from versioned evidence. v0.2.0 has no purge. +Delete is logical and reversible from versioned evidence. v0.2.1 has no purge. 1. Resolve exactly one active intake or one complete series. Require the exact identity, a deletion reason, and explicit current delete authority. diff --git a/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-artifact.1 b/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-artifact.1 index 7f3f56b..c5b78ed 100644 --- a/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-artifact.1 +++ b/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-artifact.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-INTAKE-AUTHORING-ARTIFACT 1 "July 2026" "intake-authoring-governance 0.2.0" +.TH VALIDATE-INTAKE-AUTHORING-ARTIFACT 1 "July 2026" "intake-authoring-governance 0.2.1" .SH NAME validate-intake-authoring-artifact \- validate intake series, operations, and tombstones .SH SYNOPSIS diff --git a/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-receipt.1 b/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-receipt.1 index fb79459..ec08ce6 100644 --- a/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-receipt.1 +++ b/.specify/presets/intake-authoring-governance/docs/man/validate-intake-authoring-receipt.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-INTAKE-AUTHORING-RECEIPT 1 "July 2026" "intake-authoring-governance 0.2.0" +.TH VALIDATE-INTAKE-AUTHORING-RECEIPT 1 "July 2026" "intake-authoring-governance 0.2.1" .SH NAME validate-intake-authoring-receipt \- validate intake source and output provenance read-only .SH SYNOPSIS diff --git a/.specify/presets/intake-authoring-governance/preset.yml b/.specify/presets/intake-authoring-governance/preset.yml index 6333109..efa7255 100644 --- a/.specify/presets/intake-authoring-governance/preset.yml +++ b/.specify/presets/intake-authoring-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "intake-authoring-governance" name: "Intake Authoring Governance" - version: "0.2.0" + version: "0.2.1" description: "Governs traceable intake CRUD, bounded public HTTPS sources, and explicitly approved single or series authoring." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-intake-authoring-governance" diff --git a/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.ps1 b/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.ps1 index a8360d9..565f9ed 100644 --- a/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.ps1 +++ b/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.ps1 @@ -220,7 +220,7 @@ function Test-IntakeAuthoringReceipt { $Errors.Add('generator.preset is invalid') } $GeneratorVersion = Get-HBText $Generator 'version' 'generator' - $ExpectedGenerator = if ($SchemaVersion -eq '1.0') { '0.1.0' } elseif ($SchemaVersion -eq '1.1') { '0.1.1' } elseif ($SchemaVersion -eq '2.0') { '0.2.0' } else { '' } + $ExpectedGenerator = if ($SchemaVersion -eq '1.0') { '0.1.0' } elseif ($SchemaVersion -eq '1.1') { '0.1.1' } elseif ($SchemaVersion -eq '2.0') { '0.2.1' } else { '' } if ($ExpectedGenerator -and $GeneratorVersion -ne $ExpectedGenerator) { $Errors.Add("generator.version must be $ExpectedGenerator for schema $SchemaVersion") } diff --git a/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.sh b/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.sh index 6bb87c3..c28762b 100644 --- a/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.sh +++ b/.specify/presets/intake-authoring-governance/scripts/validate-intake-authoring-receipt.sh @@ -153,7 +153,7 @@ if not isinstance(generator, dict): if required_text(generator, "preset", "generator") != "intake-authoring-governance": errors.append("generator.preset is invalid") generator_version = required_text(generator, "version", "generator") -expected_generator = {"1.0": "0.1.0", "1.1": "0.1.1", "2.0": "0.2.0"}.get(schema_version) +expected_generator = {"1.0": "0.1.0", "1.1": "0.1.1", "2.0": "0.2.1"}.get(schema_version) if expected_generator and generator_version != expected_generator: errors.append(f"generator.version must be {expected_generator} for schema {schema_version}") diff --git a/.specify/presets/intake-authoring-governance/templates/intake-authoring-receipt-template.json b/.specify/presets/intake-authoring-governance/templates/intake-authoring-receipt-template.json index 2b48557..0cf2d3a 100644 --- a/.specify/presets/intake-authoring-governance/templates/intake-authoring-receipt-template.json +++ b/.specify/presets/intake-authoring-governance/templates/intake-authoring-receipt-template.json @@ -5,7 +5,7 @@ "intakeId": "00000000-0000-0000-0000-000000000000", "generator": { "preset": "intake-authoring-governance", - "version": "0.2.0" + "version": "0.2.1" }, "createdAt": "1970-01-01T00:00:00Z", "operation": { diff --git a/.specify/presets/intake-authoring-governance/templates/intake-template.md b/.specify/presets/intake-authoring-governance/templates/intake-template.md index 88928fb..c5bb43f 100644 --- a/.specify/presets/intake-authoring-governance/templates/intake-template.md +++ b/.specify/presets/intake-authoring-governance/templates/intake-template.md @@ -3,6 +3,7 @@ **Status:** [Ready for review or blocked draft] **Audience:** [Primary audience] +**Assumed prior knowledge:** [Explicit boundary; do not assume Spec Kit experience] **Profile:** [Resolved project profile] ## Purpose @@ -34,6 +35,10 @@ [Security, privacy, accessibility, platform, supply-chain, language, and evidence applicability.] +For learner-facing intakes, state how technical and Spec Kit terms are +explained on first use and how dependencies, status, decisions, and next +actions remain available as ordered text. + ## Dependencies And Risks [Ordering, owners, constraints, stop boundaries, and follow-ups.] diff --git a/.specify/presets/intake-authoring-governance/templates/project-profile-template.md b/.specify/presets/intake-authoring-governance/templates/project-profile-template.md index 8ca52ff..48b518d 100644 --- a/.specify/presets/intake-authoring-governance/templates/project-profile-template.md +++ b/.specify/presets/intake-authoring-governance/templates/project-profile-template.md @@ -6,6 +6,10 @@ - Applies when: - Target path rule: - Language rule: +- Declared learner audience: +- Assumed prior knowledge: +- First-use terminology rule: +- Text-first dependency, status, decision, and next-action rule: - URL-source rule: - Series target and ordering rule: - Archive and tombstone rule: @@ -28,3 +32,9 @@ physical purge. Define repository-specific security, privacy, WCAG 2.2 AA, CEFR B2, platform, learning, evidence, and delivery-authority requirements. Profiles cannot weaken the preset's source, secret, overwrite, or authority protections. + +When a project declares learner-facing content, record the audience and prior +knowledge explicitly. Do not assume Spec Kit experience by default. Require +technical and workflow terms to be explained on first use, and require ordered +text for dependencies, status, decisions, and next actions even when diagrams +are also present. diff --git a/.specify/presets/intake-authoring-governance/tests/test-intake-authoring-lifecycle.ps1 b/.specify/presets/intake-authoring-governance/tests/test-intake-authoring-lifecycle.ps1 index 69a3371..125aeab 100644 --- a/.specify/presets/intake-authoring-governance/tests/test-intake-authoring-lifecycle.ps1 +++ b/.specify/presets/intake-authoring-governance/tests/test-intake-authoring-lifecycle.ps1 @@ -102,7 +102,7 @@ try { Write-HBText $Target (New-HBIntake $TargetRelative) $Receipt = [ordered]@{ schemaVersion = '2.0'; documentType = 'IntakeReceipt'; receiptId = $ReceiptId; intakeId = $IntakeId - generator = [ordered]@{ preset = 'intake-authoring-governance'; version = '0.2.0' } + generator = [ordered]@{ preset = 'intake-authoring-governance'; version = '0.2.1' } createdAt = [DateTimeOffset]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ssZ') operation = [ordered]@{ operationId = $OperationId; type = 'Create'; authorityEvidence = 'Explicit fixture create' } status = 'ReadyForReview' diff --git a/.specify/presets/intake-review-governance/README.md b/.specify/presets/intake-review-governance/README.md index e99bb91..a523a5f 100644 --- a/.specify/presets/intake-review-governance/README.md +++ b/.specify/presets/intake-review-governance/README.md @@ -1,13 +1,18 @@ # Intake Review Governance Preset Optional, stackable intake-quality governance for GitHub Spec Kit. Version -`0.1.1` provides three commands, eight templates, and read-only +`0.1.2` provides three commands, eight templates, and read-only Bash/PowerShell validators. Series reviews use a schema-1.1 request binding with normalized SHA-256, explicit roots, complete target ordering, and validated acyclic dependency edges. Single and Campaign schema 1.0 results remain compatible. Recommended priority: `65`, between Agent Parity (`60`) and Autonomous Run Governance (`70`). Spec Kit `>=0.8.3` is required. +Version `0.1.2` also reviews a project-declared learner contract. It verifies +audience and prior knowledge, first-use explanations, language and readability, +and text-first dependencies, status, decisions, and next actions without +making those project choices itself. + ## Commands - `$speckit-intake-review`: read-only semantic review for a single intake, @@ -19,7 +24,7 @@ Autonomous Run Governance (`70`). Spec Kit `>=0.8.3` is required. ## Install ```bash -specify preset add --from https://github.com/hindermath/spec-kit-preset-intake-review-governance/archive/refs/tags/v0.1.1.zip --priority 65 +specify preset add --from https://github.com/hindermath/spec-kit-preset-intake-review-governance/archive/refs/tags/v0.1.2.zip --priority 65 specify preset list specify preset resolve ``` diff --git a/.specify/presets/intake-review-governance/commands/speckit.intake-review.md b/.specify/presets/intake-review-governance/commands/speckit.intake-review.md index b9b73f6..759645a 100644 --- a/.specify/presets/intake-review-governance/commands/speckit.intake-review.md +++ b/.specify/presets/intake-review-governance/commands/speckit.intake-review.md @@ -19,6 +19,10 @@ exist. Use the installed policy and checklist. measurable acceptance, dependencies, order, security/privacy/A11Y/platform, evidence, delivery authority, risks, references, prompt alignment, and secret or unnecessary-personal-data exposure. + When project policy declares learner-facing material, also verify assumed + prior knowledge, first-use explanations for technical and Spec Kit terms, + the language/readability contract, and text-first dependencies, status, + decisions, and next actions. 3. For a series, additionally review IDs, DAG, gaps, overlap, terminology, invariants, handoffs, future scope, and authority. Use schema 1.1, declare every root, order every target exactly once, and bind the request path and diff --git a/.specify/presets/intake-review-governance/docs/README.md b/.specify/presets/intake-review-governance/docs/README.md index e213afc..8f3751a 100644 --- a/.specify/presets/intake-review-governance/docs/README.md +++ b/.specify/presets/intake-review-governance/docs/README.md @@ -5,6 +5,6 @@ runbook template defines modes, outcomes, hash normalization, repair limits, risk ownership, and Preset 7/8 consumer gates. The checklist is the normative review-dimension inventory. -Version 0.1.1 adds the binding Series graph contract: schema-1.1 request +Version 0.1.2 adds the binding Series graph contract: schema-1.1 request evidence, explicit roots, exact target ordering, edge integrity, and cycle detection with Bash/PowerShell parity. diff --git a/.specify/presets/intake-review-governance/docs/field-validation-summary.md b/.specify/presets/intake-review-governance/docs/field-validation-summary.md index 444739c..04867b9 100644 --- a/.specify/presets/intake-review-governance/docs/field-validation-summary.md +++ b/.specify/presets/intake-review-governance/docs/field-validation-summary.md @@ -1,4 +1,4 @@ -# Field Validation Summary: v0.1.1 +# Field Validation Summary: v0.1.2 Date: 2026-07-23 @@ -23,7 +23,7 @@ cycles, and root sets that differ from the graph's zero-indegree targets. The field observation from `SecureServiceHarvester-CSharp` contained 66 targets and 64 predecessor edges. An independent graph audit found an -intermediate request error that v0.1.0 could not reject. Version 0.1.1 makes +intermediate request error that v0.1.0 could not reject. Version 0.1.2 makes that class of accepted Series evidence impossible without a current, structurally valid request binding. @@ -31,7 +31,7 @@ structurally valid request binding. A temporary Spec Kit 0.12.11 project accepted all ten presets at priorities 10 through 80. `add`, `list`, `info`, `resolve`, `disable`, `enable`, `remove`, -and reinstall completed successfully with Intake Review v0.1.1 at priority 65. +and reinstall completed successfully with Intake Review v0.1.2 at priority 65. Separate temporary Codex, Claude, Copilot Skills, and Antigravity projects each contained exactly one generated surface for `speckit.intake-review`, @@ -70,7 +70,7 @@ row failed before worker scheduling. ## Disposition The tested behavior is provider-neutral and supports publication as -`intake-review-governance` v0.1.1, `autonomous-run-governance` v0.3.2, and +`intake-review-governance` v0.1.2, `autonomous-run-governance` v0.3.2, and `parallel-autonomous-run-governance` v0.2.3. The standard eight-preset profile remains unchanged; the optional authoring-and-review profile contains ten presets. diff --git a/.specify/presets/intake-review-governance/docs/man/validate-intake-review-result.1 b/.specify/presets/intake-review-governance/docs/man/validate-intake-review-result.1 index 1f88e4d..a9382be 100644 --- a/.specify/presets/intake-review-governance/docs/man/validate-intake-review-result.1 +++ b/.specify/presets/intake-review-governance/docs/man/validate-intake-review-result.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-INTAKE-REVIEW-RESULT 1 "July 2026" "intake-review-governance 0.1.1" +.TH VALIDATE-INTAKE-REVIEW-RESULT 1 "July 2026" "intake-review-governance 0.1.2" .SH NAME validate-intake-review-result \- validate a current intake review result .SH SYNOPSIS diff --git a/.specify/presets/intake-review-governance/preset.yml b/.specify/presets/intake-review-governance/preset.yml index fe91d3e..041e37d 100644 --- a/.specify/presets/intake-review-governance/preset.yml +++ b/.specify/presets/intake-review-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "intake-review-governance" name: "Intake Review Governance" - version: "0.1.1" + version: "0.1.2" description: "Reviews single, series, and campaign intake files before Spec Kit execution and binds accepted outcomes to normalized content hashes." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-intake-review-governance" diff --git a/.specify/presets/intake-review-governance/templates/intake-review-checklist-template.md b/.specify/presets/intake-review-governance/templates/intake-review-checklist-template.md index 8e05c01..be73ae9 100644 --- a/.specify/presets/intake-review-governance/templates/intake-review-checklist-template.md +++ b/.specify/presets/intake-review-governance/templates/intake-review-checklist-template.md @@ -3,6 +3,12 @@ ## Single Intake - [ ] Identity, audience, goal, scope, and non-goals are explicit. +- [ ] Assumed prior knowledge is explicit; Spec Kit experience is not silently + assumed for first-time learner audiences. +- [ ] Technical and workflow terms are explained on first use at the declared + readability level and in the project language order. +- [ ] Dependencies, status, decisions, and next actions are understandable as + ordered text and do not rely only on colour, diagrams, or visual position. - [ ] Requirements are atomic, testable, and free of conflicting modal terms. - [ ] Acceptance criteria and validation evidence are measurable. - [ ] Dependencies, ordering, authority, delivery, risks, and follow-ups are explicit. diff --git a/.specify/presets/intake-sequencing-governance/README.md b/.specify/presets/intake-sequencing-governance/README.md index 3500c87..73ad6d0 100644 --- a/.specify/presets/intake-sequencing-governance/README.md +++ b/.specify/presets/intake-sequencing-governance/README.md @@ -1,7 +1,7 @@ # Intake Sequencing Governance Optional Spec Kit preset for managing the order and lifecycle of existing -intakes. Version `0.1.0` uses priority `66`: after Intake Review at `65` and +intakes. Version `0.1.1` uses priority `66`: after Intake Review at `65` and before Autonomous Run at `70`. ## Why This Preset Exists @@ -11,11 +11,16 @@ delivery order. This preset stores both a learner-readable order and a machine-checkable typed graph. It never writes intake content and never starts the work it selects. +Version `0.1.1` preserves the project-declared learner contract in the readable +order: audience, prior knowledge, language and readability, first-use terms, +and a normative text representation of dependencies, blockers, status, +decisions, and next actions. + ## Installation ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-intake-sequencing-governance/archive/refs/tags/v0.1.0.zip \ + --from https://github.com/hindermath/spec-kit-preset-intake-sequencing-governance/archive/refs/tags/v0.1.1.zip \ --priority 66 ``` diff --git a/.specify/presets/intake-sequencing-governance/commands/speckit.intake-series-create.md b/.specify/presets/intake-sequencing-governance/commands/speckit.intake-series-create.md index b155b42..27e58ad 100644 --- a/.specify/presets/intake-sequencing-governance/commands/speckit.intake-series-create.md +++ b/.specify/presets/intake-sequencing-governance/commands/speckit.intake-series-create.md @@ -20,6 +20,10 @@ review or feature workflow. completion fact, or delivery authority. 5. Prepare manifest, receipt, operation journal, and learner-readable order document under repository-owned paths. + Preserve the project's declared audience, language order, readability, + first-use terminology, and prior-knowledge boundary. The order document + must state dependencies, blockers, status, decisions, and next actions as + text even when it also contains a diagram. 6. Validate paths, hashes, graph, lifecycle, and receipts in Bash and PowerShell before publishing any active file. 7. Publish all prepared files atomically. A failure leaves an explicit diff --git a/.specify/presets/intake-sequencing-governance/docs/field-validation-summary.md b/.specify/presets/intake-sequencing-governance/docs/field-validation-summary.md index a4fa8a4..d4df6ba 100644 --- a/.specify/presets/intake-sequencing-governance/docs/field-validation-summary.md +++ b/.specify/presets/intake-sequencing-governance/docs/field-validation-summary.md @@ -1,6 +1,6 @@ # Field Validation Summary -Version `0.1.0` is validated with: +Version `0.1.1` is validated with: - a synthetic three-target, one-root, two-edge series; - malformed path, type, binding, order, root, lifecycle, and hash fixtures; diff --git a/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-manifest.1 b/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-manifest.1 index f3c0bff..aabe158 100644 --- a/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-manifest.1 +++ b/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-manifest.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-INTAKE-SERIES-MANIFEST 1 "2026-07-25" "0.1.0" +.TH VALIDATE-INTAKE-SERIES-MANIFEST 1 "2026-07-25" "0.1.1" .SH NAME validate-intake-series-manifest.sh \- validate an intake-series manifest .SH SYNOPSIS diff --git a/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-receipt.1 b/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-receipt.1 index fcbe4a7..c50b7db 100644 --- a/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-receipt.1 +++ b/.specify/presets/intake-sequencing-governance/docs/man/validate-intake-series-receipt.1 @@ -1,4 +1,4 @@ -.TH VALIDATE-INTAKE-SERIES-RECEIPT 1 "2026-07-25" "0.1.0" +.TH VALIDATE-INTAKE-SERIES-RECEIPT 1 "2026-07-25" "0.1.1" .SH NAME validate-intake-series-receipt.sh \- validate an intake-series receipt .SH SYNOPSIS diff --git a/.specify/presets/intake-sequencing-governance/preset.yml b/.specify/presets/intake-sequencing-governance/preset.yml index 3856cc6..e44f73c 100644 --- a/.specify/presets/intake-sequencing-governance/preset.yml +++ b/.specify/presets/intake-sequencing-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "intake-sequencing-governance" name: "Intake Sequencing Governance" - version: "0.1.0" + version: "0.1.1" description: "Manages traceable intake-series order, typed dependencies, lifecycle, and next-candidate selection without executing downstream workflows." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-intake-sequencing-governance" diff --git a/.specify/presets/intake-sequencing-governance/templates/intake-series-order-template.md b/.specify/presets/intake-sequencing-governance/templates/intake-series-order-template.md index 7932a95..0845f4a 100644 --- a/.specify/presets/intake-sequencing-governance/templates/intake-series-order-template.md +++ b/.specify/presets/intake-sequencing-governance/templates/intake-series-order-template.md @@ -2,6 +2,9 @@ ## Begriffe / Terms +Explain every project-specific or Spec Kit term at first use for the declared +audience. Do not assume prior Spec Kit experience unless project policy says so. + - **Position:** bevorzugte sichtbare Lieferreihenfolge. - **Root:** Ziel ohne eingehende Kante. - **Bindende Kante:** Vorgaenger muss abgeschlossen sein. @@ -20,6 +23,10 @@ Root --> dependent intake ``` +The text table and the written dependency list are normative. A diagram may +support them, but must not be the only representation of order, blockers, +status, decisions, or the next action. + ## Naechste Kandidaten / Next Candidates Diese Liste ist eine Auskunft und startet keine Arbeit. diff --git a/.specify/presets/intake-sequencing-governance/templates/intake-series-receipt-template.json b/.specify/presets/intake-sequencing-governance/templates/intake-series-receipt-template.json index fec3bd6..bd20527 100644 --- a/.specify/presets/intake-sequencing-governance/templates/intake-series-receipt-template.json +++ b/.specify/presets/intake-sequencing-governance/templates/intake-series-receipt-template.json @@ -3,7 +3,7 @@ "documentType": "IntakeSeriesReceipt", "receiptId": "00000000-0000-0000-0000-000000000000", "seriesId": "00000000-0000-0000-0000-000000000000", - "generator": {"preset": "intake-sequencing-governance", "version": "0.1.0"}, + "generator": {"preset": "intake-sequencing-governance", "version": "0.1.1"}, "createdAt": "1970-01-01T00:00:00Z", "operation": { "operationId": "00000000-0000-0000-0000-000000000000", diff --git a/.specify/presets/intake-sequencing-governance/tests/test-intake-sequencing-validator.ps1 b/.specify/presets/intake-sequencing-governance/tests/test-intake-sequencing-validator.ps1 index ae062d5..c84c050 100644 --- a/.specify/presets/intake-sequencing-governance/tests/test-intake-sequencing-validator.ps1 +++ b/.specify/presets/intake-sequencing-governance/tests/test-intake-sequencing-validator.ps1 @@ -73,7 +73,7 @@ function Reset-Fixture { documentType = 'IntakeSeriesReceipt' receiptId = '22222222-2222-4222-8222-222222222222' seriesId = $script:Manifest.seriesId - generator = [ordered]@{ preset = 'intake-sequencing-governance'; version = '0.1.0' } + generator = [ordered]@{ preset = 'intake-sequencing-governance'; version = '0.1.1' } createdAt = '2026-07-25T00:00:00Z' operation = [ordered]@{ operationId = '33333333-3333-4333-8333-333333333333' diff --git a/.specify/presets/parallel-autonomous-run-governance/README.md b/.specify/presets/parallel-autonomous-run-governance/README.md index d457e3f..752edab 100644 --- a/.specify/presets/parallel-autonomous-run-governance/README.md +++ b/.specify/presets/parallel-autonomous-run-governance/README.md @@ -2,12 +2,17 @@ Permission-bounded coordination for several isolated autonomous Spec Kit runs. -Version `0.2.3` | Priority `80` | Spec Kit `>=0.8.3` +Version `0.2.4` | Priority `80` | Spec Kit `>=0.8.3` Required worker preset: `autonomous-run-governance >=0.2.2` Schema 1.2 optionally binds worker scheduling to a current campaign intake review. Older schemas and `required: false` retain the prior behavior. +Version 0.2.4 requires workers and consolidation to preserve the accepted +project learner and accessibility contract. Runner, provider, and model +defaults cannot weaken audience, language, readability, terminology, +prior-knowledge, or text-first requirements. + ## Deutsch ### Wofuer ist dieses Preset gedacht? @@ -66,10 +71,10 @@ Fuer regulaere Kampagnen gilt: ```bash specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ + --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.3.zip \ --priority 70 specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-parallel-autonomous-run-governance/archive/refs/tags/v0.2.3.zip \ + --from https://github.com/hindermath/spec-kit-preset-parallel-autonomous-run-governance/archive/refs/tags/v0.2.4.zip \ --priority 80 ``` diff --git a/.specify/presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md b/.specify/presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md index 49d8299..66280ea 100644 --- a/.specify/presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md +++ b/.specify/presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md @@ -12,6 +12,12 @@ Require an accepted campaign manifest, local runner-profile binding, explicit delivery authority, and `autonomous-run-governance >= 0.2.2` in every worker repository. +Resolve the shared project learner and accessibility policy before scheduling. +Every worker and the final consolidation must preserve the declared audience, +language order, readability, first-use terminology, prior-knowledge boundary, +and text-first dependency/status/decision/next-action contract. Provider or +runner defaults cannot weaken that policy. + Campaign schemas `1.0`, `1.1`, and `1.2` are supported. Schema `1.2` may declare `intakeReview.required`. When true, validate the result before any worktree or worker process is created. Require one semantic review per unique diff --git a/.specify/presets/parallel-autonomous-run-governance/docs/compatibility.md b/.specify/presets/parallel-autonomous-run-governance/docs/compatibility.md index 01494dd..0897847 100644 --- a/.specify/presets/parallel-autonomous-run-governance/docs/compatibility.md +++ b/.specify/presets/parallel-autonomous-run-governance/docs/compatibility.md @@ -8,7 +8,7 @@ | Ebene | Aktueller Wert | Bedeutung | |---|---|---| -| Preset-Release | `v0.2.3` | Veroeffentlichtes Preset-Paket | +| Preset-Release | `v0.2.4` | Veroeffentlichtes Preset-Paket | | `preset.yml`-Schema | `schema_version: "1.0"` | Spec-Kit-Presetmanifest | | Kampagnenvertrag | `schemaVersion: "1.2"` | Manifest mit optionalem Intake-Review; State/Runner/Results bleiben 1.1 | @@ -16,7 +16,7 @@ Regulaere Kampagnen benoetigen `autonomous-run-governance >=0.2.2` in jedem Worker-Repository. Die gemeinsam -getestete aktuelle Kombination ist Preset 7 `v0.3.2` mit Preset 8 `v0.2.3`. +getestete aktuelle Kombination ist Preset 7 `v0.3.2` mit Preset 8 `v0.2.4`. `requireAutonomousPreset: false` existiert fuer isolierte interne Koordinator-Fixtures. Es ist kein dokumentierter Produktionsmodus und hebt die @@ -40,9 +40,9 @@ Schema `1.1` ergaenzt: - deklarierte idempotente Post-Merge-Aktionen, - getrennte Completion-Felder. -### Upgrade auf `v0.2.3` +### Upgrade auf `v0.2.4` -`v0.2.3` ergaenzt Kampagnenschema 1.2 und das optionale Intake-Review-Gate. +`v0.2.4` ergaenzt Kampagnenschema 1.2 und das optionale Intake-Review-Gate. Schema 1.0/1.1 und Kampagnen ohne aktive Pflicht bleiben kompatibel. ## English @@ -51,7 +51,7 @@ Schema 1.0/1.1 und Kampagnen ohne aktive Pflicht bleiben kompatibel. | Layer | Current value | Meaning | |---|---|---| -| Preset release | `v0.2.3` | Published preset package | +| Preset release | `v0.2.4` | Published preset package | | `preset.yml` schema | `schema_version: "1.0"` | Spec Kit preset manifest | | Campaign contract | `schemaVersion: "1.2"` | Optional intake review in manifests; state/runners/results remain 1.1 | @@ -59,7 +59,7 @@ Schema 1.0/1.1 und Kampagnen ohne aktive Pflicht bleiben kompatibel. Regular campaigns require `autonomous-run-governance >=0.2.2` in every worker repository. The currently tested pair is Preset 7 `v0.3.2` with Preset 8 -`v0.2.3`. +`v0.2.4`. `requireAutonomousPreset: false` exists for isolated internal coordinator fixtures. It is not a documented production mode and does not replace Preset 7 @@ -76,5 +76,5 @@ Schema `1.1` adds per-worker runners, non-secret metadata, attempts and events, provider preflight, resumable merge checkpoints, declared idempotent post-merge actions, and separate completion fields. -`v0.2.3` adds campaign schema 1.2 and the optional intake-review gate. Schema +`v0.2.4` adds campaign schema 1.2 and the optional intake-review gate. Schema 1.0/1.1 and campaigns without an active requirement remain compatible. diff --git a/.specify/presets/parallel-autonomous-run-governance/docs/getting-started.md b/.specify/presets/parallel-autonomous-run-governance/docs/getting-started.md index b5fe941..f119b45 100644 --- a/.specify/presets/parallel-autonomous-run-governance/docs/getting-started.md +++ b/.specify/presets/parallel-autonomous-run-governance/docs/getting-started.md @@ -8,7 +8,7 @@ 1. Spec Kit `>=0.8.3` ist installiert. 2. Preset 7 `>=0.2.2` ist in jedem Worker-Repository aktiv. -3. Preset 8 `>=0.2.3` ist im Koordinatorprojekt aktiv. +3. Preset 8 `>=0.2.4` ist im Koordinatorprojekt aktiv. 4. Jedes Repository ist ein Git-Worktree mit bekanntem sauberem Ausgangsstand. 5. Manifest und Runner-Konfiguration enthalten keine Secrets. 6. Delivery-Modus und Remote-Berechtigungen sind ausdruecklich delegiert. @@ -21,7 +21,7 @@ specify preset add \ --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.3.2.zip \ --priority 70 specify preset add \ - --from https://github.com/hindermath/spec-kit-preset-parallel-autonomous-run-governance/archive/refs/tags/v0.2.3.zip \ + --from https://github.com/hindermath/spec-kit-preset-parallel-autonomous-run-governance/archive/refs/tags/v0.2.4.zip \ --priority 80 ``` @@ -96,7 +96,7 @@ Parallelitaet, Runner-Familien, Stop-Status und naechsten exakten Schritt. ### Prerequisites Spec Kit `>=0.8.3`, Preset 7 `>=0.2.2` in every worker repository, and Preset -8 `>=0.2.3` in the coordinator project are required. Repositories have known +8 `>=0.2.4` in the coordinator project are required. Repositories have known clean bases, manifest and local runners contain no secrets, authority is explicit, and `maxConcurrency` is between `1` and `3`. diff --git a/.specify/presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 b/.specify/presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 index 278aa90..1ab2c77 100644 --- a/.specify/presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 +++ b/.specify/presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 @@ -1,4 +1,4 @@ -.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-21" "v0.2.3" +.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-21" "v0.2.4" .SH NAME orchestrate-parallel-autonomous-runs \- validate and coordinate isolated autonomous Spec Kit campaigns .SH SYNOPSIS diff --git a/.specify/presets/parallel-autonomous-run-governance/preset.yml b/.specify/presets/parallel-autonomous-run-governance/preset.yml index 3a90ea6..e43ef9c 100644 --- a/.specify/presets/parallel-autonomous-run-governance/preset.yml +++ b/.specify/presets/parallel-autonomous-run-governance/preset.yml @@ -3,7 +3,7 @@ schema_version: "1.0" preset: id: "parallel-autonomous-run-governance" name: "Parallel Autonomous Run Governance" - version: "0.2.3" + version: "0.2.4" description: "Coordinates isolated autonomous campaigns and optionally gates worker scheduling on a current campaign intake review." author: "Thorsten Hindermann" repository: "https://github.com/hindermath/spec-kit-preset-parallel-autonomous-run-governance" diff --git a/.specify/presets/parallel-autonomous-run-governance/templates/agent-file-addendum.md b/.specify/presets/parallel-autonomous-run-governance/templates/agent-file-addendum.md index 9e08e3a..f7d29f8 100644 --- a/.specify/presets/parallel-autonomous-run-governance/templates/agent-file-addendum.md +++ b/.specify/presets/parallel-autonomous-run-governance/templates/agent-file-addendum.md @@ -48,3 +48,8 @@ inputs, but every worker still needs an applicability row. campaign manifest. - Installation grants no autonomous execution, remote write, merge, bypass, cancellation, secret, or provider-administration authority. +- Every worker inherits the accepted project's learner and accessibility + policy. Consolidation must prove that audience, language order, readability, + first-use terminology, prior-knowledge limits, and text-first dependency, + status, decision, and next-action information were preserved. Campaign + coordination must not replace these rules with provider-specific defaults. From e6a2c44a9b0ac0745318a54aa36e7e8d02562fac Mon Sep 17 00:00:00 2001 From: Thorsten Hindermann Date: Sat, 25 Jul 2026 18:45:27 +0200 Subject: [PATCH 2/2] docs: refresh project statistics --- docs/project-statistics.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/project-statistics.md b/docs/project-statistics.md index 4c7790e..9ebaef4 100644 --- a/docs/project-statistics.md +++ b/docs/project-statistics.md @@ -486,25 +486,25 @@ Profil 2 verwendet Git-getrackte Textdateien und sichtbare Git-Aktivitaet. Die W | Kennzahl / Metric | Wert / Value | |---|---:| -| Textbasis / Text base | 196839 lines | +| Textbasis / Text base | 197084 lines | | Textdateien / Text files | 1607 | | Beobachtbarer Zeitraum / Observable period | 2025-07-27..2026-07-25 | | Aktivtage / Active days | 74 | -| Relevante Commits / Relevant commits | 289 | -| Zeilen je Aktivtag / Lines per active day | 2660.0 | +| Relevante Commits / Relevant commits | 290 | +| Zeilen je Aktivtag / Lines per active day | 2663.3 | | Peak-Tag im Fenster / Peak day in window | 2026-02-14 / 177480 | | Peak-Woche im Fenster / Peak week in window | 2026-02-08 / 186065 | | Laengste Serie / Longest streak | 9 days | -| Speedup vs. 80 lines/day | 33.2x | +| Speedup vs. 80 lines/day | 33.3x | | Speedup vs. 125 lines/day | 21.3x | -| Methodik / Methodology | v2; source `fce8d51dd7de` | +| Methodik / Methodology | v2; source `d7d0dacccb87` | ### Artefaktmix / Artifact Mix ```text Produktiv / Production [#...................] 3.6% | 7165 Tests [#...................] 2.6% | 5089 -Dokumentation / Documentation [###########.........] 53.6% | 105437 +Dokumentation / Documentation [###########.........] 53.6% | 105682 Skripte / Scripts [#...................] 4.9% | 9603 Konfiguration / Configuration [#######.............] 33.0% | 65032 Daten und Medien / Data and media [....................] 0.0% | 0 @@ -619,7 +619,7 @@ Die festen Slots halten den Phasenvergleich auch bei fehlenden oder spaeter erga ```text Scale: 0..50x -80 lines/day [#############.......] 33.2x +80 lines/day [#############.......] 33.3x 125 lines/day [#########...........] 21.3x ``` @@ -633,7 +633,7 @@ Die Faktoren vergleichen sichtbare Lieferdichte mit den dokumentierten manuellen Scale: 0..5000 lines/day Experienced manual [#...................] 80 Thorsten solo [#...................] 125 -Visible repository [###########.........] 2660.0 +Visible repository [###########.........] 2663.3 ``` Die gemeinsame Skala vergleicht Referenzen und sichtbare Lieferdichte. Sie schreibt die Git-Aktivitaet keiner Person oder KI pauschal zu. @@ -659,6 +659,6 @@ DE: Das Fenster beginnt am 2025-07-27 und endet am 2026-07-25. Es enthaelt 74 ak | 2026-04 | 17036 | | 2026-05 | 12329 | | 2026-06 | 37668 | -| 2026-07 | 57146 | +| 2026-07 | 57755 |