JC Beasley
ed5dff8ebd
Adds: - ARCHITECTURE.md: Full documentation of 3-layer system - Context Pipeline: Preprocessing layer (pipeline.js) - Workflow Router: 4 fixed workflows (coding, debug, deploy, audit) - Validation Layer: Post-response quality gate (validator.js) - Format Templates: Structured output templates - TOOLS.md: Beavault connection documentation Architecture: - Layer 1: Behavior rules (always injected) - Layer 2: Persistent facts (structured memory) - Layer 3: Ephemeral context - Priority enforcement: Rules > Prefs > Task > Chat - Memory write policy: Only confirmed fixes, repeated preferences
41 lines
851 B
Markdown
41 lines
851 B
Markdown
# Workflow: Troubleshooting
|
|
|
|
## Intent Classification
|
|
|
|
**Triggers:** Errors, failures, unexpected behavior, debugging requests
|
|
|
|
## Fixed Output Format
|
|
|
|
```markdown
|
|
## Problem
|
|
[Symptom observed]
|
|
|
|
## Diagnosis
|
|
- Checked: [what was checked]
|
|
- Found: [what was found]
|
|
|
|
## Cause
|
|
[Root cause - trace to why, not just what]
|
|
|
|
## Fix
|
|
[What was changed]
|
|
|
|
## Validation
|
|
[How verified it's fixed]
|
|
```
|
|
|
|
## Tool Access Rules
|
|
|
|
1. **Inspect first** - logs, config, state before changing anything
|
|
2. **Reproduce** - understand the failure before fixing
|
|
3. **Trace to root** - fix cause, not symptom
|
|
4. **Document** - add to ISSUES.md if pattern
|
|
|
|
## Constraints
|
|
|
|
- NO: Restart-as-first-response
|
|
- NO: Regex patches without understanding root cause
|
|
- NO: Fixes without verification
|
|
- YES: Documented workaround if root cause blocked
|
|
- YES: Regression test if applicable
|