docs: add Zensical documentation site#36
Merged
Conversation
eshulman2
reviewed
May 12, 2026
Collaborator
eshulman2
left a comment
eshulman2
left a comment
There was a problem hiding this comment.
Thanks a lot for the PR, I added some comments on it, mostly need to change some references on skills to match the new skill installer feature :)
Adds a full documentation site built with Zensical (next-gen Material for MkDocs). Includes 15 content pages, GitHub Actions deployment to GitHub Pages, and uv-managed dependencies. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Replace stale skill-set contribution section in contributing.md with "Customize Forge for your project" covering forge project-setup, forge skills install/list/update, and auto-sync via Jira property - Fix stale cross-reference in skills/authoring.md - Add forge-poller as recommended local dev option alongside ngrok in getting-started.md, with setup steps and webhook secret note - Expand Epic Decomposition and Task Generation human action blocks in feature-workflow.md with revision tables and per-gate Mermaid diagrams (update_single_epic, regenerate_all_epics, update_single_task, etc.) - Apply wording fix: "similar approval gates at each planning stage" - Add Documentation section to README pointing to DOCS.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
zensical.tomlconfiguration with Mermaid diagrams, GLightbox, dark/light mode, tabbed code blocksghp-importon every push tomainthat touches docszensicalandghp-importadded asdocsoptional-dependencies inpyproject.toml— managed viauvDOCS.mdexplains how to run, build, and deploy locallyHow to run locally
uv sync --extra docs uv run zensical serve # preview at http://localhost:8000Deploy manually
Then enable GitHub Pages under Settings → Pages → Source →
gh-pagesbranch.Test plan
uv run zensical buildcompletes with no issues founduv run zensical serve— check nav tabs, Mermaid diagrams, dark/light mode toggle, searchhttps://forge-sdlc.github.io/forge/🤖 Generated with Claude Code