I have intentions to add more skills and plugins to this repo

Plan Clarity

/pc-review --help

the plan-clarity plugin is designed to generate a static html to reduce the cognitive load of reviewing a plan. it has the added benefit of improving the quality and clarity of a plan

• see intended diffs
• see data stuctures and transformations
• outline logic flows and where logic is added, transformed or removed
• see data lifecycles and how this plan will change them
• list questions and concerns categorized and ranked by severity and make it easy to respond to all of them at once.
• outline execution steps and phases with annotations

it currently has a few behaviors that I still want to chagne

• api page is redundant with logic page
• difficult/slow to make edits
• I would like to make the code diffs more consistent by using real code diffs and applying some sort of comment style syntax for annotations

screenshots

!TODO - I'll post screenshots in a bit

dependencies

npm i -g bun live-server

• bun reduces the size of the node_modules on disk by using hardlinks. useful when we have multiple reviews.
• live-server auto-updates the html on edit/build

how to use

call /pc-review or /plan-clarity:pc-review and point it to the plan or code you want to presnet. It will decide which phases are appropriate to display and execute sub-agents to build those pages.

a svelte website will be created in /docs/review/

cd /docs/review/{name} && bun i

bun dev # see live app - edits appear as they're made, may be annoying as the page tends to reset while you're looking at it

bun run build && cd dist && live-server index.html # app only refreshes after all changes are made and `bun run build` is called