Skip to content

v0.2 foundation: roadmap, rule-ID fixes, and corpus protocol - #1

Merged
LinusAurel merged 9 commits into
mainfrom
roadmap/v0.5-foundation
Aug 22, 2026
Merged

LinusAurel merged 9 commits into
mainfrom
roadmap/v0.5-foundation

Conversation

@LinusAurel

@LinusAurel LinusAurel commented Aug 22, 2026 •

Copy link
Copy Markdown
Owner

Summary

Start the v0.2 Evidence and Reliability phase.

Included

  • add ROADMAP.md covering v0.2 through v1.0 and the parallel Agent Skill track
  • fix validator findings that emitted non-existent STG-DE-* IDs instead of the published STG rule IDs
  • add regression tests that verify emitted IDs exist in rules/rule-index.yaml
  • publish current rule automation coverage in quality/RULE-COVERAGE.md
  • define development/validation/holdout corpus methodology in corpus/PROTOCOL.md
  • link the roadmap and quality documents from the README

Important validator corrections

  • STG-DE-8.1 -> STG-8.1 for semicolon findings
  • STG-DE-1.1 -> STG-1.1 for controlled vocabulary findings
  • STG-DE-9.4 -> STG-9.4 for project terminology findings
  • STG-DE-5.1 -> STG-5.1 for procedure sentence limits
  • STG-DE-6.3 -> STG-6.3 for description sentence limits

This PR intentionally does not add speculative NLP enforcement. v0.2 starts by making the deterministic surface trustworthy and measurable.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d8833c32cb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread corpus/PROTOCOL.md

A source is eligible when:

- it is public, licensed for the intended analysis, or otherwise available for lawful internal evaluation;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Restrict corpus inputs to approved sources

When a contributor has lawful internal access to a private document but no explicit approval to use it in public repository metrics, this eligibility rule permits that source and the protocol later requires reporting derived results. Require sources contributing to repository-facing validation artifacts to be public or explicitly approved, while carving out any strictly internal-only evaluation separately.

AGENTS.md reference: AGENTS.md:L19-L19

Useful? React with 👍 / 👎.

Comment thread tools/stg_lint.py
if ";" in line and not line.lstrip().startswith("#"):
findings.append(Finding(
"error", "STG-DE-8.1", "Semikolon verwenden Sie nicht. Teilen Sie den Satz.",
"error", "STG-8.1", "Semikolon verwenden Sie nicht. Teilen Sie den Satz.",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Synchronize the packaged linter after changing IDs

When users run the packaged Agent Skill, skills/simplified-technical-german/scripts/stg_lint.py remains the old generated copy and still emits nonexistent STG-DE-* IDs, while these changes and tests affect only the canonical linter. Run python tools/sync_skill.py so the bundled execution path receives the corrected IDs as well.

AGENTS.md reference: AGENTS.md:L12-L13

Useful? React with 👍 / 👎.

Comment thread ROADMAP.md
@@ -0,0 +1,179 @@
# STG-DE Roadmap

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Rebuild the manifest for this file set

Adding these documents and modifying README, tests, and the canonical linter without regenerating manifest.yaml leaves the new files unlisted and retains stale hashes for the modified files. After the separate skill-sync failure is corrected, the manifest-integrity loop in tools/validate_release.py rejects this tree at the README hash, preventing release validation from passing.

AGENTS.md reference: AGENTS.md:L15-L15

Useful? React with 👍 / 👎.

Comment thread README.md

- **75 rules and recommendations** for German controlled writing.
- A stable rule index for all **75** STG-DE rules and recommendations.
- A traceable mapping of all **53 ASD-STE100 Issue 9 writing rules**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add the claimed ASD-STE100 mapping

The reviewed commit tree contains no mapping/ path, and a repo-wide search for ASD-STE100 traceability finds only this README claim; rules/rule-index.yaml provides internal STG rule indexing but no mapping of the 53 source rules. Add the canonical mapping data or remove the advertised feature and directory until it exists.

AGENTS.md reference: AGENTS.md:L11-L11

Useful? React with 👍 / 👎.

@LinusAurel
LinusAurel merged commit 4a779f2 into main Aug 22, 2026
2 checks passed
@LinusAurel
LinusAurel deleted the roadmap/v0.5-foundation branch November 12, 2026 14:22
@LinusAurel LinusAurel changed the title v0.5 foundation: roadmap, rule-ID fixes, and corpus protocol v0.2 foundation: roadmap, rule-ID fixes, and corpus protocol Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant