Skip to content

Add Best-Practice spec track (bestPracticeSpec/0.1.0) #85

Description

@a6b8

Introduce a third, advisory spec track best-practice/0.1.0 alongside Specification and Grading (Memo 108).

Scope

  • best-practice/0.1.0/ source: 00-introduction, 01-overview, schema-creation/10–14 (BP-1..BP-5: readable interface, reference data, load & scale, geo conventions, correctness & license).
  • Version entry in data/refs.manual.json (+ refs.schema.json definition + additive block in generate-refs.mjs).
  • Third generation pass in generate-docs-payload.mjs (generatePass made recursive, content-neutral for spec/grading) + manifest.bestPractice in generate-manifest.mjs.

Character

Advisory ("should, not must") — recommendations + learnings; published as best-practices.txt (in the docs repo) for source-first subagent prompts.

Verified: ajv refs gate green, payload + manifest blocks generated, test:refs-regex + test:e2e pass.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions