Skip to content

Commit aa61afe

Browse files
committed
chore: sync system instructions
1 parent ce35aa8 commit aa61afe

File tree

1 file changed

+9
-39
lines changed

1 file changed

+9
-39
lines changed

CLAUDE.md

Lines changed: 9 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -11,21 +11,10 @@
1111

1212
## Tool Hierarchy
1313

14-
**For coding tasks (default):** Use Serena MCP for precise searches, edits, refactors, symbol lookups, and large/ongoing work.
15-
16-
**For repository overview:** Use Repomix when full-structure context is needed, then switch to Serena for implementation.
17-
18-
**For specialized operations:**
19-
- Context7 MCP: Version-specific library documentation
20-
- Web Search/Reader: Breaking changes, latest syntax
21-
- ZRead/GitHub CLI: Remote repo exploration
22-
- Vision MCP: Image verification and UI debugging
23-
- Playwright: E2E testing and interaction
24-
- Task tool: Parallel sub-agents for independent work
25-
26-
**Plugin Skills:** Use feature-dev plugins (brainstorming, planning, diagnostics) and project-specific skills when available instead of reinventing analysis.
27-
28-
**Last resort:** Only use generic bash scripting or brittle regex when the above tools lack the capability.
14+
- Default Behavior: Always use built-in tools and actions, including sub-agents and agent team when appropriate, only looking for external tools when the built-in aren't capable of efficiently achieve your goal.
15+
- Plugin Skills: Use plugins (feature-dev, frontend-design, planning, diagnostics, etc.) and skills when available instead of reinventing analysis.
16+
- MCPs: WebSearch, WebFetch, Vision, ZRead, Context7, Repomix, Playwright, Serena.
17+
- Last resort: Only use generic bash scripting or brittle regex when the above tools lack the capability.
2918

3019
## Code Standards
3120

@@ -37,16 +26,15 @@
3726

3827
## Testing Strategy
3928

40-
Unit Tests for: Specific input/output pairs, edge cases, error paths.
41-
42-
Property-Based Tests for: Invariants, commutativity, idempotency, round-trip serialization.
29+
- Unit Tests for: Specific input/output pairs, edge cases, error paths.
30+
- Property-Based Tests for: Invariants, commutativity, idempotency, round-trip serialization.
4331

4432
## Workflow
4533

4634
### Before Coding
4735
1. Check current date/year for temporal context.
48-
2. Serena: Explore codebase structure and patterns.
49-
3. Context7/Web Search: Verify current syntax and versions (do not rely on training data).
36+
2. Explore codebase structure and patterns.
37+
3. Verify current syntax and versions (do not rely on training data).
5038
4. Define: Goal, Acceptance Criteria, Definition of Done (files off-limits), Non-goals.
5139

5240
### Trivial Edits Exception
@@ -62,24 +50,6 @@ Run in order, committing at each green step:
6250
6. Full E2E suite
6351
7. Visual regression (if applicable)
6452

65-
## When Stuck
66-
67-
After 3 failed attempts:
68-
1. Git reset to last green state.
69-
2. Re-read requirements.
70-
3. Serena: Trace symbols and references to understand dependencies.
71-
4. Create minimal reproduction in ./playground.
72-
5. Decompose to atomic TDD cycles (target <10 lines each).
73-
6. Spawn 2-8 parallel diagnostic tasks via Task tool.
74-
7. Escalate to human with findings.
75-
76-
## Context Hygiene
77-
78-
At 32 turns:
79-
1. Write checkpoint.md: Current Goal, Recent Changes, Next Step, Open Questions.
80-
2. Commit it.
81-
3. Reset context and resume from checkpoint.
82-
8353
## Language Pitfalls
8454

8555
Go:
@@ -93,4 +63,4 @@ C#:
9363
- Prefer LINQ except in hot paths.
9464

9565
Windows:
96-
- Use pwsh.exe (v7+), never powershell.exe (v5.1).
66+
- Use pwsh.exe (v7+), never powershell.exe (v5.1).

0 commit comments

Comments
 (0)