8cc99ab483
Major restructure of the compounding-engineering plugin: ## Agents (24 total, now categorized) - review/ (10): architecture-strategist, code-simplicity-reviewer, data-integrity-guardian, dhh-rails-reviewer, kieran-rails-reviewer, kieran-python-reviewer, kieran-typescript-reviewer, pattern-recognition-specialist, performance-oracle, security-sentinel - research/ (4): best-practices-researcher, framework-docs-researcher, git-history-analyzer, repo-research-analyst - design/ (3): design-implementation-reviewer, design-iterator, figma-design-sync - workflow/ (6): bug-reproduction-validator, every-style-editor, feedback-codifier, lint, pr-comment-resolver, spec-flow-analyzer - docs/ (1): ankane-readme-writer ## Commands (15 total) - Moved workflow commands to commands/workflows/ subdirectory - Added: changelog, create-agent-skill, heal-skill, plan_review, prime, reproduce-bug, resolve_parallel, resolve_pr_parallel ## Skills (11 total) - Added: andrew-kane-gem-writer, codify-docs, create-agent-skills, dhh-ruby-style, dspy-ruby, every-style-editor, file-todos, frontend-design, git-worktree, skill-creator - Kept: gemini-imagegen 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
3.1 KiB
3.1 KiB
module, date, problem_type, component, symptoms, root_cause, rails_version, resolution_type, severity, tags
| module | date | problem_type | component | symptoms | root_cause | rails_version | resolution_type | severity | tags | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
Troubleshooting: [Clear Problem Title]
Problem
[1-2 sentence clear description of the issue and what the user experienced]
Environment
- Module: [Name or "CORA system"]
- Rails Version: [e.g., 7.1.2]
- Affected Component: [e.g., "Email Processing model", "Brief System service", "Authentication controller"]
- Date: [YYYY-MM-DD when this was solved]
Symptoms
- [Observable symptom 1 - what the user saw/experienced]
- [Observable symptom 2 - error messages, visual issues, unexpected behavior]
- [Continue as needed - be specific]
What Didn't Work
Attempted Solution 1: [Description of what was tried]
- Why it failed: [Technical reason this didn't solve the problem]
Attempted Solution 2: [Description of second attempt]
- Why it failed: [Technical reason]
[Continue for all significant attempts that DIDN'T work]
[If nothing else was attempted first, write:] Direct solution: The problem was identified and fixed on the first attempt.
Solution
[The actual fix that worked - provide specific details]
Code changes (if applicable):
# Before (broken):
[Show the problematic code]
# After (fixed):
[Show the corrected code with explanation]
Database migration (if applicable):
# Migration change:
[Show what was changed in the migration]
Commands run (if applicable):
# Steps taken to fix:
[Commands or actions]
Why This Works
[Technical explanation of:]
- What was the ROOT CAUSE of the problem?
- Why does the solution address this root cause?
- What was the underlying issue (API misuse, configuration error, Rails version issue, etc.)?
[Be detailed enough that future developers understand the "why", not just the "what"]
Prevention
[How to avoid this problem in future CORA development:]
- [Specific coding practice, check, or pattern to follow]
- [What to watch out for]
- [How to catch this early]
Related Issues
[If any similar problems exist in docs/solutions/, link to them:]
- See also: another-related-issue.md
- Similar to: related-problem.md
[If no related issues, write:] No related issues documented yet.