aiwf-render

Generates a static HTML site from aiwf planning entities with epic, milestone, and status pages.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwf-render-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwf-render
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-render
Command: npx skills add https://github.com/23min/aiwf --skill aiwf-render-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project planning state stored as markdown entities is hard to browse and share with stakeholders who need a readable, navigable view of epics, milestones, gaps, and decisions without running CLI commands. ## Core Features & Use Cases - Static HTML rendering: Runs aiwf render --format=html to produce a self-contained site with an epic index, per-epic and per-milestone detail pages, and a status page, all sharing one embedded stylesheet with no JavaScript or runtime dependencies. - Area grouping and priority badges: Partitions epics by declared areas in aiwf.yaml and renders priority pill badges for gaps and decisions carrying a priority value. - Deterministic, read-only output: Re-running into the same output directory produces byte-identical files, emits a JSON envelope for CI scripts, and never creates commits. - Use Case: A team lead asks to publish the project status page before a review meeting; the skill renders the full governance site into site/ and the lead opens index.html or deploys it via GitHub Pages. ## Quick Start Ask the assistant to render the governance HTML site with aiwf render and then open the generated index.html in a browser.

Frequently Asked Questions about aiwf-render

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render the aiwf planning state as HTML?

Run `aiwf render --format=html` to generate a static site containing index.html, one page per epic and milestone, status.html, and a shared stylesheet. Use `--out <dir>` to override the default output directory from aiwf.yaml.

What is the difference between aiwf render --format=html and aiwf render roadmap?

The HTML format produces a full static site with per-entity pages and a status view, while `aiwf render roadmap` generates a markdown ROADMAP.md with an epics and milestones table. Both are render subcommands but target different surfaces.

Does the aiwf HTML renderer require JavaScript or external assets?

No. The renderer ships a single embedded stylesheet and produces pages with no JavaScript, no runtime, and no external assets. Milestone tab navigation uses `:target`-driven CSS so per-tab URLs remain bookmarkable.

Can I commit the rendered HTML output to the repository?

Yes. Set `commit_output: true` under the html block in aiwf.yaml and re-run `aiwf update` to remove the gitignore entry. By default the output directory is gitignored and most projects publish via CI instead.

Why is a page or tab missing from the rendered aiwf site?

The renderer is a pure projection of the planning tree, so missing content usually indicates validation findings. Run `aiwf check` first to surface reference, status, or frontmatter problems before investigating the render itself.