Skip to content

Hardware pillar, source ranking, core notation and lesson flow - #8

Merged
WDrijver merged 1 commit into
mainfrom
structure-hardware-basis
Nov 3, 2026
Merged

WDrijver merged 1 commit into
mainfrom
structure-hardware-basis

Conversation

@WDrijver

@WDrijver WDrijver commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Structure changes agreed before splitting TuKo1982's "68080 compilation and optimisation guide" into the knowledge base. No content from that guide yet; that follows in PRs per pillar.

Changes

  • hardware/ pillar next to core/, os/ and toolchain/:
    • v4-generic/ for shared knowledge, plus v4-standalone/ (SA), v4-unicorn/ (UNI, A6000), v4-icedrake/ (ICE), v4-manticore/ (MC) and v4-firebird/ (FB);
    • best-practices/ and pitfalls/;
    • optional applies_to.board;
    • new component hardware;
    • hardware/index.md with the models and abbreviations.
  • Source ranking:
    • inline tags after facts: (G) core developer, (M) measured, (official), (SRC) source code;
    • optional basis field, checked in CI;
    • new conflict rule in AGENTS.md section 4: source rank first, then the newer core, then status. A measured fact now beats the PRM.
  • Core notation: any, Core 12841, Core 12830-12840 or Core 12841+, checked in CI.
  • Templates:
    • Evidence section in the pitfall and lesson templates;
    • basis and board in all file templates;
    • target core and model in templates/repo/AGENTS.md.
  • Lesson flow (AGENTS.md section 8, CONTRIBUTING section 7, templates/repo/AGENTS.md):
    • When agents offer a lesson: at the end of a project, release or milestone, and right away after a wrong assumption.
    • The developer approves the draft first.
    • Submitting: preferably a PR from the knowledge base submodule; otherwise the new issue form "Submit a lesson".
    • Distilling lessons (step 4) is unchanged.
  • PRM converter:
    • adds basis: [official];
    • keeps a file's status while its body is unchanged, so metadata changes no longer reset reviewed (all 89 files stay reviewed).

Knowledge base files relied on

  • CONTRIBUTING.md sections 2, 4, 7 and 11

🤖 Generated with Claude Code

- hardware/ pillar: v4-generic and one folder per V4 model, with
  optional applies_to.board and the common model abbreviations.
- Source ranking: inline tags (G), (M), (official), (SRC), an optional
  basis field, and a new conflict rule in AGENTS.md (core developer,
  then measured, then official documentation).
- Core notation "Core 12841", "Core 12830-12840", "Core 12841+" or
  "any", checked in CI.
- Evidence section in the pitfall and lesson templates.
- Lesson flow: agents offer a lesson at the end of a project or after
  a wrong assumption, and submit it with approval as a PR from the
  knowledge base submodule, or through the new issue form.
- PRM converter: basis [official]; status is kept while the body is
  unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@WDrijver
WDrijver requested a review from TuKo1982 as a code owner November 3, 2026 11:29
@WDrijver
WDrijver merged commit 8c31464 into main Nov 3, 2026
2 checks passed
@WDrijver
WDrijver deleted the structure-hardware-basis branch November 3, 2026 11:32
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