Skip to content

README Likely Workspace Shape diagram shows a manifests/ directory that does not exist #447

@codeforester

Description

@codeforester

Problem

README.md "Likely Workspace Shape" section (around line 1001–1013) shows this layout:

work/
  base/
    README.md
    cli/
      bash/
      python/
    lib/
    manifests/     ← does not exist
  project-a/
  ...

The manifests/ directory does not exist in the Base repository. Project manifests live in lib/base/ (default_manifest.yaml, dev_manifest.yaml) and at the root of each project repository (base_manifest.yaml). There is no top-level manifests/ directory.

The diagram also omits several directories that do exist: docs/, tests/, bin/, demo/, bootstrap.sh.

Fix

Replace the stale workspace shape diagram with one that reflects the actual current repository layout. Either show a simplified but accurate base/ subtree, or link to the repository structure table already present in CLAUDE.md which is kept up to date.

A minimal accurate replacement could be:

work/                          ← shared workspace root (workspace.root)
  base/                        ← Base repository (BASE_HOME for source checkout)
  project-a/                   ← peer project with base_manifest.yaml
  project-b/                   ← peer project with base_manifest.yaml

This removes the stale base/ internals which are documented better in docs/architecture.md and CLAUDE.md.

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions