PowerForge Website Starter
Follow a deterministic "golden path" so agents can build sites without guessing.
Golden Path (Do This In Order)
- Identify the repo root and build outputs.
- Repo root contains
site.jsonandpipeline.json. - Output is usually
./_site, temp is./_temp.
- Repo root contains
- Make the site explicit (avoid inference).
- In
site.jsonsetdefaultTheme,features, and navigation.
- In
- Standardize pipeline modes (dev vs ci).
- Dev: fast iteration; skip heavy steps.
- CI/release: strict; fail on new issues; enforce budgets.
- Make the theme portable and contract-driven.
- Prefer
theme.manifest.jsonwithschemaVersion: 2. - Declare
featuresandfeatureContracts(required layouts/partials/slots + CSS selectors).
- Prefer
- Ensure page layouts include required hooks.
- Scriban:
{{ extra_css_html }},{{ extra_scripts_html }},{{ assets.css_html }},{{ assets.js_html }}.
- Scriban:
- Make API docs use site chrome and correct CSS.
- Provide
api-header/api-footerpartials that match the site header/footer structure/classes. - Use multi-CSS:
"/css/app.css,/css/api.css"(or the equivalent for the site). - Emit API coverage report (
coverageReport) so CI can track documentation completeness. - For PowerShell APIs, wire
psExamplesPath(or rely onExamples/discovery) to enable fallback examples when help XML is sparse.
- Provide
- Add quality gates with an escape hatch.
- Use baselines for legacy noise; fail only on new issues in CI.
- Run locally in dev and ci modes and verify output.
- Dev should warn, not spam, and stay fast.
- CI should be deterministic and block regressions.
- Update agent handoff docs so the next agent knows where everything is.
- Paths to sibling repos, theme structure, and the site’s “rules”.
Reference Files (Read As Needed)
references/blueprint.md: minimal recommendedsite.json/pipeline.json/theme contract patterns.references/theme-contracts.md: feature contract checklist (docs/apiDocs/blog/search/404).references/agent-prompts.md: copy/paste prompts for Claude/agents (new site, refactor theme, fix api docs).
Converted and distributed by TomeVault — claim your Tome and manage your conversions.