feat(ultraplan-local): v1.6.0 — /ultraresearch-local deep research command
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>
This commit is contained in:
commit
caee558e79
152 changed files with 17734 additions and 0 deletions
169
skills/config-hierarchy/references/rules-directory.md
Normal file
169
skills/config-hierarchy/references/rules-directory.md
Normal file
|
|
@ -0,0 +1,169 @@
|
|||
# .claude/rules/ Directory Reference
|
||||
|
||||
## Purpose
|
||||
|
||||
The `.claude/rules/` directory allows modular organization of instructions with optional path scoping.
|
||||
|
||||
## Location
|
||||
|
||||
```
|
||||
project/
|
||||
├── .claude/
|
||||
│ └── rules/
|
||||
│ ├── code-style.md
|
||||
│ ├── testing.md
|
||||
│ └── api.md
|
||||
└── CLAUDE.md
|
||||
```
|
||||
|
||||
## File Format
|
||||
|
||||
Each rule file is a markdown file with optional frontmatter:
|
||||
|
||||
```markdown
|
||||
---
|
||||
paths: ["src/**/*.ts", "src/**/*.tsx"]
|
||||
description: TypeScript code style rules
|
||||
---
|
||||
|
||||
# TypeScript Rules
|
||||
|
||||
## Formatting
|
||||
- Use 2-space indentation
|
||||
- Prefer single quotes
|
||||
|
||||
## Types
|
||||
- Always use explicit types for function parameters
|
||||
- Avoid `any` type
|
||||
```
|
||||
|
||||
## Frontmatter Options
|
||||
|
||||
### paths (Official) / globs (Legacy)
|
||||
|
||||
Array of glob patterns that scope when this rule applies.
|
||||
|
||||
**Official field name:** `paths:` (as per Claude Code documentation)
|
||||
**Legacy/alternative:** `globs:` (also supported for backwards compatibility)
|
||||
|
||||
Both fields behave identically - use `paths:` for new rules:
|
||||
|
||||
```yaml
|
||||
---
|
||||
paths: ["src/**/*.ts"] # Official - Only for TypeScript in src/
|
||||
---
|
||||
```
|
||||
|
||||
```yaml
|
||||
---
|
||||
globs: ["src/**/*.ts"] # Legacy - Still works, but prefer paths:
|
||||
---
|
||||
```
|
||||
|
||||
```yaml
|
||||
---
|
||||
paths: ["tests/**/*", "**/*.test.ts"] # Test files anywhere
|
||||
---
|
||||
```
|
||||
|
||||
If no paths/globs specified, rule applies everywhere.
|
||||
|
||||
**Note:** Config-audit normalizes both to `patterns` internally and tracks which field was used via `pattern_source`.
|
||||
|
||||
### description
|
||||
|
||||
Brief description of what the rule covers:
|
||||
|
||||
```yaml
|
||||
---
|
||||
description: Code formatting and style preferences
|
||||
---
|
||||
```
|
||||
|
||||
### alwaysApply
|
||||
|
||||
Force rule to always be included regardless of current file:
|
||||
|
||||
```yaml
|
||||
---
|
||||
alwaysApply: true
|
||||
---
|
||||
```
|
||||
|
||||
## Loading Behavior
|
||||
|
||||
1. Rules are loaded when entering relevant directories
|
||||
2. Glob patterns are matched against current file/directory
|
||||
3. Matching rules are included in context
|
||||
4. Non-matching rules are not loaded
|
||||
|
||||
## Example Rules
|
||||
|
||||
### code-style.md
|
||||
|
||||
```markdown
|
||||
---
|
||||
paths: ["src/**/*"]
|
||||
description: Source code style
|
||||
---
|
||||
|
||||
# Code Style
|
||||
|
||||
- TypeScript > JavaScript
|
||||
- Explicit types for public API
|
||||
- Document exported functions
|
||||
```
|
||||
|
||||
### testing.md
|
||||
|
||||
```markdown
|
||||
---
|
||||
paths: ["tests/**/*", "**/*.test.ts", "**/*.spec.ts"]
|
||||
description: Testing guidelines
|
||||
---
|
||||
|
||||
# Testing
|
||||
|
||||
- Use Jest for unit tests
|
||||
- Descriptive test names
|
||||
- Arrange-Act-Assert pattern
|
||||
```
|
||||
|
||||
### api.md
|
||||
|
||||
```markdown
|
||||
---
|
||||
paths: ["src/api/**/*", "src/routes/**/*"]
|
||||
description: API development rules
|
||||
---
|
||||
|
||||
# API Guidelines
|
||||
|
||||
- RESTful conventions
|
||||
- Validate all inputs
|
||||
- Consistent error responses
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Split by concern**: One rule file per topic
|
||||
2. **Use specific globs**: Avoid overly broad patterns
|
||||
3. **Keep rules focused**: 200-500 words per file
|
||||
4. **Document purpose**: Use description frontmatter
|
||||
5. **Review periodically**: Remove outdated rules
|
||||
|
||||
## Migration from CLAUDE.md
|
||||
|
||||
To convert from monolithic CLAUDE.md to rules:
|
||||
|
||||
1. Identify distinct sections in CLAUDE.md
|
||||
2. Create rule file for each section
|
||||
3. Add appropriate globs
|
||||
4. Remove sections from CLAUDE.md
|
||||
5. Test that rules load correctly
|
||||
|
||||
## Debugging
|
||||
|
||||
To see which rules are loaded:
|
||||
- Check Claude Code logs
|
||||
- Rules appear in context when relevant files are active
|
||||
Loading…
Add table
Add a link
Reference in a new issue