OpenParable
Skip to content
← Back to skills

Brainstorm Sync

Productivity
brainstorm-sync

Brainstorm Sync is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Sync brainstorming session discoveries to project memory (CONTEXT.md, memories)

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/brainstorm-sync/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/brainstorm-sync, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Brainstorm Sync

After a brainstorming session, capture valuable discoveries in project memory so future sessions benefit.

When to Use

  • After completing a brainstorming session (feature-tree:brainstorm skill)
  • When significant design decisions were made
  • When user intentions or project context became clearer

What to Sync

1. CONTEXT.md Updates

Brainstorming often reveals or clarifies:

SectionWhat might have changed
ProblemRefined understanding of the pain point
Target UsersMore specific user personas discovered
Success CriteriaClearer metrics identified
ConstraintsNew constraints or removed assumptions
Key AssumptionsNew assumptions marked [untested]

Process:

  1. Read current .feat-tree/CONTEXT.md
  2. Ask: "Did this session reveal anything new about the problem, users, or constraints?"
  3. Update relevant sections (preserve existing content, add new insights)

2. Memory Updates

Create or update memories based on brainstorming discoveries:

Discovery TypeMemory File
Technical decisionstechnical_decisions.md
Scope fences (explicit "nots")scope.md
User insights (Day-In-Life)users.md
Core assumptions (Crux)Update CONTEXT.md assumptions
Pre-mortem risksrisks.md

3. Design Reference

If a design doc was created:

# memories/designs.md

## Recent Designs

- 2026-01-03: Bootstrap Redesign (docs/plans/2026-01-03-bootstrap-phase1-design.md)
  - Two-phase feature discovery
  - Confidence levels on all output

Process

Step 1: Review Session

Ask yourself:

  • What did we learn about the user/problem?
  • What technical decisions were made and why?
  • What scope fences were established?
  • What assumptions were identified?

Step 2: Update CONTEXT.md

Read, identify changes, update:

# Read current context
cat .feat-tree/CONTEXT.md

Update sections that changed. Don't rewrite what's already accurate.

Step 3: Update/Create Memories

For each significant discovery:

  1. Check if a relevant memory file exists
  2. Update existing or create new
  3. Keep it dense — same info, fewer tokens

Step 4: Confirm

Synced to project memory:
- CONTEXT.md: [what changed]
- memories/technical_decisions.md: [created/updated]
- memories/scope.md: [created/updated]

Future sessions will have this context.

Guidelines

  • READ before WRITE — Don't duplicate existing content
  • Dense > verbose — Same information, fewer tokens
  • Only sync reusable insights — Skip session-specific details
  • Preserve existing content — Add to, don't replace