Add /ultraresearch-local for structured research combining local codebase analysis with external knowledge via parallel agent swarms. Produces research briefs with triangulation, confidence ratings, and source quality assessment. New command: /ultraresearch-local with modes --quick, --local, --external, --fg. New agents: research-orchestrator (opus), docs-researcher, community-researcher, security-researcher, contrarian-researcher, gemini-bridge (all sonnet). New template: research-brief-template.md. Integration: --research flag in /ultraplan-local accepts pre-built research briefs (up to 3), enriches the interview and exploration phases. Planning orchestrator cross-references brief findings during synthesis. Design principle: Context Engineering — right information to right agent at right time. Research briefs are structured artifacts in the pipeline: ultraresearch → brief → ultraplan --research → plan → ultraexecute. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
CLAUDE.md Structure Reference
Purpose
CLAUDE.md files provide context and instructions to Claude Code for your project or globally.
File Locations
| Location | Purpose | Shared? |
|---|---|---|
~/.claude/CLAUDE.md |
Global defaults | No |
./CLAUDE.md |
Project shared | Yes |
./.claude/CLAUDE.md |
Alt project location | Yes |
./CLAUDE.local.md |
Local overrides | No |
Common Sections
Project Context
# Project Name
Brief description of what this project does.
## Architecture
- Technology stack
- Key components
- Dependencies
Coding Standards
## Coding Standards
- Language preferences (TypeScript > JavaScript)
- Formatting rules
- Naming conventions
Commands/Workflows
## Available Commands
| Command | Description |
|---------|-------------|
| /build | Build the project |
| /test | Run tests |
Environment Setup
## Development Setup
1. Install dependencies: `npm install`
2. Set environment variables: see `.env.example`
3. Run dev server: `npm run dev`
Frontmatter (Optional)
CLAUDE.md can have YAML frontmatter:
---
model: sonnet
allowed-tools: Read, Write, Bash
---
@Imports
Reference other files:
# Main CLAUDE.md
@./docs/architecture.md
@./CONTRIBUTING.md
The imported files are loaded and included in context.
Best Practices
- Keep it focused: Don't repeat generic info
- Update regularly: Keep sync with project changes
- Use imports: Split large files into modules
- Be specific: Give concrete examples, not vague guidelines
- Local for secrets: Use CLAUDE.local.md for sensitive paths
Size Recommendations
| File | Recommended Size |
|---|---|
| Global CLAUDE.md | 1-2 KB |
| Project CLAUDE.md | 2-5 KB |
| With imports | Total 5-10 KB |
Larger files consume more context tokens.