8 docs tagged with "authoring"

Break a feature / ClickUp parent task / design doc into one or more GitHub issues with the BeWith 6-section template + AI-assigned labels. Thin wrapper around the breakdown skill.

Capture a "what's missing / what we could change" POC observation into docs/insights/ — fast, separate from proposals. Thin wrapper around the insight skill; the 2-3 day review promotes agreed insights to a proposal/ADR/task.

Start authoring a new platform artifact — agent, skill, command, rule, hook, or policy. Wraps the new-artifact skill.

R&D-side fallback that turns a raw product exploration (spec + mockup + remarks + ClickUp link) into the canonical PRD when the Cowork normalizer was skipped. Thin wrapper over the prd-writer agent; the resulting PRD is a draft the product owner must review and own.

Drive the architect to turn a PRD into a complete, reviewable Design Doc — researches the codebase and writes the full doc (TL;DR, API/schema/components, task breakdown with effort sizes), iterating on open questions. Not a skeleton.

Record a discussion that reached decisions as a durable ADR or Decision log entry, then offer to break its action items into tasks. Thin wrapper around the decision-record skill.

Propose a feature / infrastructure / process idea — drafts a markdown file under docs/proposals/ for the team to triage.

Propose a generic insight as a team rule — opens a PR on bewith-docs for team discussion.