Skip to content

Standards hardening: typeDiagram models, PR auto-merge/own-PR, strict protection + website/CI updates#16

Merged
MelbourneDeveloper merged 11 commits into
mainfrom
websitestuff
Jun 19, 2026
Merged

Standards hardening: typeDiagram models, PR auto-merge/own-PR, strict protection + website/CI updates#16
MelbourneDeveloper merged 11 commits into
mainfrom
websitestuff

Conversation

@MelbourneDeveloper

Copy link
Copy Markdown
Collaborator

TLDR

Hardens the portfolio standards (typeDiagram data models, PR auto-merge + own-PR-until-green, strict branch protection, Deslop CI-gate consistency) and ships the accompanying website/CI/template updates.

What Was Added?

  • Spec [MODEL-TYPEDIAGRAM] (docs/specs/REPO-STANDARDS-SPEC.md) — data models MUST be generated from typeDiagram, never hand-written; codegen wired into make build; file a typeDiagram issue when it can't express a case. Mirrored as a universal Hard Rule in templates/AGENTS.md and the assessment checklist.
  • Own-PR-until-green rule in spec [BRANCH-AGENT] and templates/AGENTS.md — agents enable auto-merge, monitor, and fix-and-push until checks pass; never hand back a red/running PR.
  • submit-pr skill — new "enable auto-merge" step (gh pr merge --auto --squash) and a prominent git-exception callout (git allowed only for PR submit/monitor; never co-author).
  • Strict branch protection in templates/.github/common-repo-settings.md — mandate strict_required_status_checks_policy + allow_update_branch; ruleset is repaired in place (existence is not conformance).
  • Website releases page assets (templates/website/release.js, releases.njk) and CodeQL/release template refinements.

What Was Changed or Deleted?

  • code-dedup skill — bare deslop . (reads .deslop.toml) is the CI gate; removed the contradictory hardcoded --fail-over 5.0 "CI gate" line.
  • ci.yml — corrected stale Playwright version comment (1.58.2 → 1.60.0); website-only PRs skip dashboard tests via a change-detection gate.
  • templates/AGENTS.md — trimmed redundant fluff for higher signal density.
  • Website content updates (index, features, get-started, how-it-works, base layout, site data).

How Do The Automated Tests Prove It Works?

CI runs make test (F# fixture/integration tests that generate the dashboard HTML, then Playwright E2E against it) in the Microsoft Playwright container. This PR touches non-website files, so the change-detection job marks code=true and the full dashboard-tests job runs. No dashboard F# code (repo-report.fsx) or its tests changed, so a green dashboard-tests run demonstrates the standards/website/template edits introduce no regression. The security job (dependency review) also runs.

Spec / Doc Changes

  • docs/specs/REPO-STANDARDS-SPEC.md: new [MODEL-TYPEDIAGRAM], [BRANCH-AGENT] own-PR rule, Deslop CI-gate consistency, two new checklist items.
  • agent-pmo-skill/templates/AGENTS.md, agent-pmo-skill/SKILL.md, AGENTS.md, README.md, dashboard/README.md: standards/instruction updates.
  • agent-pmo-skill/templates/skills/{submit-pr,code-dedup}/SKILL.md, common-repo-settings.md: see above.

Breaking Changes

  • None

Detect whether a PR touches anything outside website/**; the heavy F#/Playwright dashboard suite now runs only when it does. A new always-running "Test" gate (the required status check) passes when the dashboard tests pass or are legitimately skipped, so website-only PRs stay fast and mergeable while code PRs still gate on real tests.

Also track templates/.claude/settings.local.json (the canonical artifact referenced by the spec and skill; it was hidden by a global ~/.config/git/ignore rule).
…trict protection, Deslop consistency

- Spec [MODEL-TYPEDIAGRAM]: data models MUST be generated from typeDiagram, never
  hand-written; codegen wired into `make build`; file an issue if typeDiagram can't
  express a case. Mirrored as a universal Hard Rule in templates/AGENTS.md + checklist.
- Spec [BRANCH-AGENT] + templates/AGENTS.md: agents OWN every PR until green — enable
  auto-merge, monitor, fix-and-push until checks pass; never hand back red/running.
- submit-pr skill: enable auto-merge (`gh pr merge --auto --squash`); prominent git-
  exception callout (git allowed only for PR submit/monitor; never co-author).
- code-dedup skill: bare `deslop .` (reads .deslop.toml) is the CI gate — dropped the
  contradictory hardcoded `--fail-over 5.0` "CI gate" line ([CI-DESLOP]).
- common-repo-settings: mandate strict required status checks + allow_update_branch;
  branch-protection ruleset is repaired in place (existence is not conformance).
- ci.yml: correct stale Playwright version comment (1.58.2 -> 1.60.0).
- templates/AGENTS.md: trim redundant fluff.
@MelbourneDeveloper
MelbourneDeveloper enabled auto-merge (squash) June 17, 2026 11:43
@MelbourneDeveloper
MelbourneDeveloper merged commit 372ce7f into main Jun 19, 2026
7 checks passed
@MelbourneDeveloper
MelbourneDeveloper deleted the websitestuff branch June 19, 2026 09:58
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