Skip to content

refactor: declutter root into docs/ + group presets/ by concern - #24

Merged
CMaintz merged 2 commits into
mainfrom
refactor/layout-docs-and-presets
Sep 26, 2026
Merged

CMaintz merged 2 commits into
mainfrom
refactor/layout-docs-and-presets

Conversation

@CMaintz

@CMaintz CMaintz commented Sep 25, 2026

Copy link
Copy Markdown
Owner

Unified restructure — the layout half (the other session's plan; the workflow _-prefix + ruleset-guard composite action follow in a second PR). Superseded my #22/#23 (closed).

Root decluttered: OVERVIEW/DESIGN/FEATURES + designs/ → docs/. Root keeps README/LICENSE/CHANGELOG/CONTRACT + the release-please/commitlint/renovate configs (tool-fixed).

presets/ grouped by concern: lint/ (eslint + pmd) · security/ (gitleaks) · tickets/ (ticket-schema + ISSUE_TEMPLATE) · agent/ (agent-loop, code-standards, collaboration) · baselines/ (flaky-baseline). habit-hooks/, arch/, prompt-eval/, renovate.json unchanged.

Safety: all of this is consumer-invisible — only foundry-init pulls presets, and its gitleaks/pmd fetch paths are updated in lockstep; reusable workflows run in the caller's checkout and don't touch foundry's presets. All moves via git mv (history preserved). README + the narrative docs' cross-links relativized.

Follow-ups (small, low-harm): FEATURES' inventory table + a few doc text path-mentions want an accuracy pass; then PR2 = workflow _-prefix + tier0→_guards + the composite action.

Move narrative docs (OVERVIEW/DESIGN/FEATURES) + design specs (designs/) under docs/;
root keeps README/LICENSE/CHANGELOG/CONTRACT + the release-please/commitlint/renovate
configs. Group presets/ by concern: lint/ (eslint + pmd), security/ (gitleaks), tickets/
(ticket-schema + ISSUE_TEMPLATE), agent/ (agent-loop, code-standards, collaboration),
baselines/ (flaky-baseline). habit-hooks/, arch/, prompt-eval/, renovate.json stay put.

Consumer-invisible except foundry-init (gitleaks + pmd fetch paths updated); reusable
workflows run in the caller's checkout, not foundry's presets. README + narrative-doc
cross-links updated. FEATURES inventory table + minor text path-mentions: follow-up.
The typos check (lint-workflows) flagged it in the demo cast/svg + its source
build-cast.mjs. Fixed all three so they stay consistent (the .cast/.svg are generated
from the .mjs; hand-fixed here to match without regenerating the whole cast).
@CMaintz
CMaintz merged commit 3b0566c into main Sep 26, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant