fact-find

Scan cards and topics to produce planning or system briefing notes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/PeterCowling/base-shop --skill fact-find-petercowling
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fact-find
Source: https://github.com/PeterCowling/base-shop/tree/main/.claude/skills/fact-find
Command: npx skills add https://github.com/PeterCowling/base-shop --skill fact-find-petercowling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill gathers evidence and context required to plan by scanning cards, ideas, and topics. It supports both a planning workflow (fact-find briefing) and an understanding-only briefing, ensuring you have the right anchors before you proceed.

Core Features & Use Cases

  • Discovery mode: When run without a specific topic, scans Business OS for raw ideas, cards in Inbox, and cards in Fact-finding lane, then presents options for the user to select.
  • Outcomes: Planning Fact-Find Brief that feeds directly into /plan-feature, or System Briefing Note that explains current workings.
  • Intake & sufficiency gates: Collects minimum inputs to determine intent and scope before auditing the repository.

Quick Start

Run the fact-find skill to begin discovery and evidence gathering, or provide a topic to seed a Planning Fact-Find Brief.

Frequently Asked Questions about fact-find

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

FAQPage Schema
How do I gather evidence and context for planning a new feature?▼

To gather evidence and context for planning, you can run a discovery scan across your Business OS cards, ideas, and topics to produce a Planning Fact-Find Brief. This brief collects the necessary anchors and feeds directly into your feature planning workflow.

What is a fact-find briefing and when do I need one?▼

A fact-find briefing is a structured document that explains current system behavior or feeds feature planning by defining discovery, intake questions, and sufficiency gates. You need one when you must audit a repository to ensure you have the right context before proceeding with a plan.

Can I generate a system briefing note to document current behavior without planning?▼

Yes, you can generate a System Briefing Note to document and explain current system workings. This outcome focuses on understanding existing behavior rather than producing a Planning Fact-Find Brief for new feature development.

How do I start an investigation if I don't have a specific topic?▼

If you start an investigation without a specific topic, the discovery mode scans your Business OS for raw ideas, inbox cards, and fact-finding lane cards. It then presents these options for you to select and seed your briefing.

What inputs are required to pass the sufficiency gates for a planning brief?▼

To pass sufficiency gates, you must provide minimum intake inputs that determine your intent and scope. The skill audits your repository based on these inputs to ensure enough evidence exists before generating the Planning Fact-Find Brief.