Feel the pulse of your code.
Pulz is an Agent Skill that guides LLM / Coding Agents to diagnose and fix code bugs using Traditional Chinese Medicine (TCM) diagnostic methodology.
Instead of jumping to a fix, Pulz enforces a structured four-phase examination -- Observation, Listening, Inquiry, Palpation -- to fully understand a bug before prescribing a minimal-invasive repair. The core philosophy: treat the root cause, not the symptom.
| Phase | TCM Concept | What the Agent Does |
|---|---|---|
| 1. Observation | Wang-Zhen | Static code analysis: structure, complexity, code smells |
| 2. Listening | Wen-Zhen | Runtime signal analysis: logs, errors, performance data |
| 3. Inquiry | Wen-Zhen (Inquiry) | Context collection: environment, recent changes, reproduction conditions |
| 4. Palpation | Qie-Zhen | Dynamic debugging: reproduction tests, data flow tracing |
| Diagnosis | Bian-Zheng | Synthesize findings into a Bug Profile |
| Treatment | Shi-Zhi | Generate minimal-invasive fix with reproduction test |
Copy the pulz/ directory into your project or agent's skill discovery path:
cp -r pulz/ /path/to/your/skills/
pulz/
SKILL.md # Core skill instructions
references/
OBSERVATION-GUIDE.md # Phase 1: static analysis checklist
LISTENING-GUIDE.md # Phase 2: error pattern catalog
INQUIRY-GUIDE.md # Phase 3: question templates
PALPATION-GUIDE.md # Phase 4: debugging strategies
assets/
diagnosis-report-template.md # Structured output template
Place the pulz/ directory under .claude/skills/ in your project root:
.claude/skills/pulz/SKILL.md
Place the pulz/ directory where your agent discovers skills. Refer to your
agent's documentation for the appropriate path.
See spec.md for the complete design specification, including planned features beyond bug fixing (visualization, CI/CD integration, adaptive learning, etc.).