bootstrap

Audit repository documentation gaps and generate Pivot-pattern planning files.

1|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/joi-fairshare/agentic-workflow --skill bootstrap-joi-fairshare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap
Source: https://github.com/joi-fairshare/agentic-workflow/tree/main/bootstrap
Command: npx skills add https://github.com/joi-fairshare/agentic-workflow --skill bootstrap-joi-fairshare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures every repository hits the Pivot doc standard by auditing existing planning and product documentation, detecting gaps in the required 17 artifacts plus CLAUDE.md, and aligning new content with the codebase context and any optional external product references.

Core Features & Use Cases

  • Documentation Audit: Analyze the repository tree, README, CLAUDE.md, and planning conventions to count which Pivot artifacts already exist and list the missing ones with their intended purpose.
  • Doc Generation: Generate planning/*.md files, CLAUDE.md, .claude/rules/, and the Serena configuration by invoking explore/write agents that adapt content to the repo tech stack, stack-specific patterns, and optional external docs provided via --product-docs.
  • Prep for Collaboration: Clean up with Serena onboarding hints, warnings about missing rule directories or bridges, and a final report guiding next steps for product vision, architecture, and design collaboration.

Quick Start

Run /bootstrap from the repo root to audit documentation coverage, generate missing Pivot-pattern artifacts, and set up CLAUDE.md plus Serena configuration.

Frequently Asked Questions about bootstrap

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

FAQPage Schema
How do I generate missing planning documentation for a codebase before kickoff?

To generate missing planning documentation for a codebase, analyze the repository tree to audit existing artifacts and create required planning/*.md files, CLAUDE.md, and Serena configuration adapted to your tech stack.

What is the Pivot documentation standard for repository planning?

The Pivot documentation standard requires 17 specific planning artifacts plus a CLAUDE.md file to ensure comprehensive product, architecture, testing, and release documentation coverage for a repository.

How do I audit existing repository documentation to find missing planning files?

Audit existing repository documentation by analyzing the repo tree, README, and CLAUDE.md to count existing Pivot artifacts and list missing files with their intended purpose for release preparation.

Can I use external product sources when generating repository documentation?

You can reference verified external product sources during documentation generation by providing them via the --product-docs flag, allowing the tool to align new content with external references.

Does the documentation bootstrap process set up Serena configuration and rules directories?

The documentation bootstrap process sets up Serena configuration and .claude/rules/ directories while providing onboarding hints and warnings about missing rule bridges for collaboration prep.

What is the best way to prepare a repository for product vision and architecture collaboration?

The best way to prepare a repository for collaboration is to run a documentation audit that generates missing planning artifacts and outputs a final report guiding next steps for product vision and architecture.