Skip to content

repokit-check: declared-but-planned START-HERE paths fail the check #31

Description

@PBNZ

Problem

the-standard.md says not to pre-create empty directories ("directories are created when first populated" / "don't pre-create empty directories", Growing the docs/ folder). But scripts/repokit-check.ps1 asserts that every path-like token in the START-HERE map resolves. A row declaring the planned component layout of a monorepo (e.g. backticked firmware/, app/) therefore fails the self-check, even though not creating those directories yet is exactly what the standard prescribes.

Observed while scaffolding a private collection-type repo: the planned-layout row produced 3 FAILs; the workaround was rewording the row to avoid path-like tokens — which works but hides useful, greppable path names from the map.

Suggestion

Support a marker the checker skips, e.g. a row (or token) annotated (planned):

| Planned component layout | firmware/(planned),app/ (planned) |

Alternatively: only assert existence for rows whose label is in the known required set (resume state, changelog, ADRs, ...), and treat all other rows as documentation.

🤖 Generated with Claude Code

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