Skip to main content
CORE:C:0035 deterministic high coherence core

Directory Layout Documented

The main instruction file must include a section documenting the project's directory layout using a heading like "Structure", "Architecture", "Layout", or "Directory" and containing a tree listing or path references. Without a visible directory map, the agent cannot reliably locate or place files.

Antipatterns

  • Heading without content like ## Structure followed by prose that says "see the repo" — the heading matches but the deterministic pattern requires tree characters or path references underneath.
  • Describing layout in prose only like "Source code lives in the src directory and tests are in tests" — the check requires structural markers (/, tree characters) not just prose mentions.
  • Layout in a separate file with no reference in the main file — the check targets type: main, so the layout must appear in CLAUDE.md or equivalent.

Pass / Fail

Pass

## Structure
```
src/
├── core/
├── interfaces/
└── formatters/
tests/
```

Fail

The project has source code and tests organized in directories.
See the repository for the full structure.

Limitations

Checks for a heading containing "Directory", "Layout", "Structure", or "Tree". Does not verify the section contains an actual directory tree or file listing.