Help us improve
Share bugs, ideas, or general feedback.
From foundation
Seldon — restructure a project's docs into a standard taxonomy and build the hierarchical AGENTS.md context tree. Moves docs into typed folders, archives superseded ones, generates an INDEX, and authors root + per-boundary AGENTS.md. Run /foundation:doc-inventory first. Trigger: /foundation:doc-restructure
npx claudepluginhub sashabogi/foundation-plugin --plugin foundationHow this skill is triggered — by the user, by Claude, or both
Slash command
/foundation:doc-restructureThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
The second phase. Consumes the manifest from `/foundation:doc-inventory` and reshapes the docs into the
Creates p5.js generative art with seeded randomness, noise fields, and interactive parameter exploration. Use for algorithmic art, flow fields, or particle systems.
Share bugs, ideas, or general feedback.
The second phase. Consumes the manifest from /foundation:doc-inventory and reshapes the docs into the
standard. Do it as ONE reviewable git commit (renames preserve history). See PROJECT_STRUCTURE_STANDARD.md.
<project>/
AGENTS.md # root: project-wide rules + Child Index (the hierarchical context tree)
CLAUDE.md # Claude-native; can stay full law or become a thin pointer to AGENTS.md
docs/
INDEX.md # the human catalog (categorized, status-iconed)
architecture/ specs/ plans/ runbooks/ decisions/ audits/ reference/ planned/ archive/
<boundary>/AGENTS.md # LOCAL rules per durable boundary (services/, src/, db/, …)
Markdown is the single source of truth. Naming: kebab-case.md; superseding → move to archive/ (never
delete) + forward-link. A child AGENTS.md may specialize but never weakens a global non-negotiable.
README.md/CLAUDE.md/CHANGELOG.md, any
design-system or skill files referenced by path, and cohesive subsystem clusters (keep them intact).docs/<category>/<kebab>.md;
PLANNED → docs/planned/; SUPERSEDED/STALE → docs/archive/. Check for collisions. Show it for review.git mv (preserves history). Create the taxonomy folders first.docs/INDEX.md from the manifest — grouped by category, each entry with a status icon.AGENTS.md (project orientation + structural rules + the Child Index
pointing to each child) and a child AGENTS.md at each durable boundary, seeded from any existing
CLAUDE.md content + the project's known gotchas (pull from Foundation memories). Keep children to LOCAL
rules only. Add the AGENTS-tree pointer to CLAUDE.md.git add -A -- '*.md').Verification: no flat docs left in docs/; INDEX lists every doc; the SessionStart AGENTS-walk hook
(shipped with Foundation) now auto-surfaces the root AGENTS.md — confirm it appears in a fresh session.