Skip to content

Draft KDE-RFC-020: architecture documents with team-stated layout rules - #19

Open
emafriedrich wants to merge 1 commit into
mainfrom
rfc-020-architecture-documents
Open

emafriedrich wants to merge 1 commit into
mainfrom
rfc-020-architecture-documents

Conversation

@emafriedrich

Copy link
Copy Markdown
Owner

What

Drafts KDE-RFC-020: a per-domain architecture document that records how the code is organized, so agents read the layout from the context receipt instead of re-deriving it from the directory tree every session.

The shape is deliberately left open. The RFC proposes a cycle, not a schema:

  1. The team states its layout rules in its own words (no rules shipped by KDE).
  2. The agent proposes a verifiable form for each rule and tries it against the real tree.
  3. Iterate until the check is deterministic, or the rule stays as prose marked "not verified".
  4. Deterministic checks run through knowledge:check, the hook and CI, as knowledge drift does today.

One firm boundary: checks read paths, names and content patterns; they never parse a language.

Status draft, drafted_by: agent. Open Questions are intentionally many; the author will refine them in a later pass.

Also

  • knowledge/methodology/CONTEXT.md regenerated (adds the RFC line).
  • knowledge:check ok (70 documents, same pre-existing warnings).

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