Skip to content

The "ten binding principles" are two different lists depending on which file you read #24

Description

@cameri

The ten principles are the acceptance criteria every schematic is audited against, so there should be exactly one list. There are two:

File #8 #9 Has "Configuration flexibility"? Has "Composable in kind"?
README.md Applicable context stated Configuration flexibility yes no
skills/.../references/schematic-principles.md (the audit checklist) Applicable context stated Configuration flexibility yes no
skills/.../create-schematic/SKILL.md Composable in kind Applicable context stated no yes
skills/.../templates/SCHEMATIC.template.md (copied into every spec) Composable in kind Applicable context respected no yes
llms.txt lists "composable", not "configuration flexibility" no yes

So the self-audit checklist (schematic-principles.md) has no entry for composition at all, while the template every new schematic copies has no entry for configuration flexibility. The index.html spec section should be checked against whichever list wins.

Also in the template, principle 6 is garbled (a line was merged and its tail left behind):

6. **Parameterized and modular** — all tunables flow from the Parameters table; behavior differences between deployments are configuration, never code edits
   table; concerns are separated per the Modules section.

Every schematic that copied the template since carries that line (authorize-docker-requests on #19 has the older, correct wording, others have the broken one).

Proposed

Pick one list (eleven principles is a legitimate answer, since "composable" and "configuration flexibility" are different properties), then update README, SKILL.md, principles.md (add a verify block for the missing one), the template, llms.txt, and index.html in a single change, and fix the principle-6 line in the template and in the specs that inherited it.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions