Claude Code Workflow

The most productive NeuralRepo workflow combines Claude for brainstorming with Claude Code for building. This guide walks through the full pattern.

The Pattern

The workflow has four phases:

Brainstorm in Claude — explore ideas conversationally.
Save to NeuralRepo — persist the best ideas via MCP.
Switch to Claude Code — pull ideas into a project directory.
Build with context — Claude Code uses the idea as a spec.

This creates a clean separation: Claude is your thinking partner, NeuralRepo is your memory, and Claude Code is your builder.

Prerequisites

NeuralRepo MCP server connected to both Claude.ai and Claude Code. See the MCP setup guide.
The nrepo CLI installed. See CLI installation.

Phase 1: Brainstorm in Claude

Start a conversation in Claude.ai and think through your idea:

You: I want to build a CLI tool that generates changelogs from git commits. It should group commits by type (feat, fix, chore) and support conventional commits. What do you think?

Claude: That is a solid idea. Here are some considerations…

Parse conventional commit prefixes (feat:, fix:, chore:, etc.)

Group by type with headings

Support a date range filter

Output as markdown

Optional: detect breaking changes from BREAKING CHANGE footers

Iterate until the idea is well-formed.

Phase 2: Save to NeuralRepo

Once you have something worth keeping, ask Claude to save it:

You: Save this as an idea in NeuralRepo. Tag it with cli, devtools, and mvp.

Claude: (calls save_idea) Saved as idea #63: “CLI changelog generator from git commits” with tags cli, devtools, mvp.

If related ideas exist, link them:

You: Link this to idea #28 about the git workflow tools.

Claude: (calls link_ideas) Linked idea #63 to #28 with relation type “related.”

Phase 3: Switch to Claude Code

Open your terminal, navigate to your project directory, and start Claude Code:

mkdir changelog-cli && cd changelog-cli
claude

Now pull the idea into context:

You: Search my NeuralRepo for the changelog generator idea

Claude Code: [calls search_ideas with query "changelog generator"]
Found idea #63: "CLI changelog generator from git commits" (captured)
  Tags: cli, devtools, mvp
  Body: Parse conventional commit prefixes, group by type...

You: Pull that idea into this project

Claude Code: [runs: nrepo pull 63 --to ./]
Created ./idea-63-cli-changelog-generator.md

You: Read that file and set up the project — initialize a Node.js package,
     create the CLI entry point, and implement the core logic.

Phase 4: Build with Context

Claude Code now has the full idea context and can build accordingly. As you work, keep the idea status updated:

You: Update idea 63 to building status

Claude Code: [calls update_idea with id=63, status="building"]
Updated.

When you ship:

You: Update idea 63 to shipped and add the npm package URL

Claude Code: [calls update_idea with id=63, status="shipped",
  body="... Published as changelog-gen on npm."]
Done.

Searching Before New Work

Before starting any new project, make it a habit to search NeuralRepo:

You: Before we start, search my NeuralRepo for anything related to
     "API monitoring" or "endpoint health checks"

Claude Code: [calls search_ideas]
Found 3 related ideas:
  - #14: "API uptime dashboard" (exploring)
  - #31: "Health check endpoint standard" (captured)
  - #45: "Alerting system for API failures" (shelved)

This surfaces prior thinking and prevents you from rebuilding what you have already explored.

Full Conversation Example

Here is a complete session across both tools:

In Claude.ai:

You: I need a GitHub Action that posts PR size labels (S, M, L, XL)
     based on lines changed. Let's think through the design.

Claude: [discusses design, thresholds, label colors, edge cases]

You: Great, save this to NeuralRepo tagged with github, actions, devtools

Claude: [saves idea #71]

In Claude Code:

You: Search NeuralRepo for the PR size labels idea

Claude Code: [finds idea #71, displays details]

You: Pull it and build a GitHub Action based on the spec

Claude Code: [pulls idea, scaffolds the action, implements logic]

You: Looks good. Update idea 71 to building.

Claude Code: [updates status]

... after testing and publishing ...

You: Mark idea 71 as shipped

Claude Code: [updates to shipped]

Tips

Use tags consistently. Tags like mvp, v2, and blocked help you filter ideas in Claude Code searches.
Link related ideas. When Claude Code finds multiple related ideas, link them so the graph builds naturally.
Keep the body updated. As you learn things during building, update the idea body. It becomes a project journal.
Review weekly. Use the weekly digest to stay on top of stale ideas.

Next Steps

Claude Code Integration Detailed setup guide for connecting NeuralRepo to Claude Code.

Idea to Project The full lifecycle workflow from captured idea to shipped project.