bs

Plans are written as markdown with a small set of directives — callouts, cards, labels, mermaid diagrams, and file trees — rendered with a consistent design language by the Fiberplane desktop app.

Install

With npx skills (recommended)

npx skills add fiberplane/bs --skill bs

Manual (Claude Code)

Clone the repo and copy the skill into Claude Code's skills directory:

git clone https://github.com/fiberplane/bs.git /tmp/fiberplane-bs
mkdir -p ~/.claude/skills
cp -R /tmp/fiberplane-bs/skills/bs ~/.claude/skills/bs

Manual (.agents)

Clone the repo and copy the skill into your .agents skills directory:

git clone https://github.com/fiberplane/bs.git /tmp/fiberplane-bs
mkdir -p ~/.agents/skills
cp -R /tmp/fiberplane-bs/skills/bs ~/.agents/skills/bs

Usage

Once installed, ask the agent to brainstorm or create a visual plan:

> brainstorm an auth system migration plan
> bs: architecture overview for the new API gateway
> create a visual plan for the database refactor

The agent writes markdown with directives and saves it to your project via the fp CLI.

How it works

The agent produces a markdown file — directives for callouts, cards, labels, mermaid diagrams, and file trees — then stores it locally with fp brainstorm create. Brainstorms live alongside your code, versioned on every update, and can be read from the terminal (fp bs show <id>) or opened in the Fiberplane desktop app for a fully rendered view with inline comments.

The skill only produces content — all styling, theming, and layout live in the renderer, so plans stay concise and consistent across light and dark modes.

What you get

• Markdown-first plans — portable, diff-able, versioned on every update
• Rich directives — callouts, cards, labels, file trees
• Mermaid diagrams — flowcharts, sequence, state, class, ER, gantt, and timeline
• Light/dark theme support — rendered consistently by the desktop app
• Inline comments — leave feedback anchored to specific blocks via fp bs comments

License

MIT