MeatyCapture Skill

Request-log markdown files for development tracking.

Capture Method Selection

| Scenario | Method | Tokens/Effort | |----------|--------|---------------| | Single capture during development | mc-quick.sh | ~50 tokens | | AI agent capturing findings | mc-quick.sh | ~50 tokens | | Batch capture (3+ items) | Direct CLI | ~200+ tokens | | Complex notes or custom fields | Direct CLI | ~200+ tokens | | Appending to existing docs | Direct CLI | ~150 tokens | | Post-commit: update docs + close item | update-bug-docs.py | ~20 tokens | | Batch file bugs (3+) from JSON/CSV | batch-file-bugs.sh | ~30 tokens |

Scripts spec: .claude/specs/script-usage/bug-automation-scripts.md

Document/Item Structure

• Document: Container for related items (a topic, feature, or daily log)
• Item: Individual request within a document

Aggregation Rules

| Type | Strategy | |------|----------| | bug | Daily aggregation - all bugs from same day in one doc titled "Bug Log - YYYY-MM-DD" | | enhancement/idea/task/question | One doc per topic (title = request title, often 1 item) |

When to Use Multiple Items per Doc

• Related sub-tasks of a larger feature (manually specify doc-id)
• Multiple bugs captured in same session (automatic daily aggregation)
• Batch of similar requests for same topic

Quick Capture Script

Ultra-simple wrapper - reduces ~20 lines JSON to single command:

mc-quick.sh TYPE DOMAIN SUBDOMAIN "Title" "Problem" "Goal" [notes...]

# Examples:
mc-quick.sh enhancement web deployments "Add remove button" "Button not implemented" "Full removal workflow"
mc-quick.sh bug api validation "Fix timeout" "Sessions expire early" "Extend TTL to 24h"

# With environment variables:
MC_PROJECT=other-project MC_PRIORITY=high mc-quick.sh bug cli commands "Title" "Problem" "Goal"

Environment Variables: MC_PROJECT (default: skillmeat), MC_PRIORITY (default: medium), MC_STATUS (default: triage)

Full documentation: ./usage-specs/mc-quick-script.md

Quick Commands (use /mc for simple operations)

| Command | Example | |---------|---------| | List | meatycapture log list PROJECT --json | | View | meatycapture log view PATH --json | | Search | meatycapture log search "query" PROJECT --json | | Capture | meatycapture log create --json < input.json | | Note Add | meatycapture log note add DOC ITEM -c "text" | | Update | meatycapture log item update DOC ITEM --status done |

Workflows (load only when needed)

| Action | When to Load | |--------|--------------| | Capture | Batch capture, validation, templates | | View/Search | Advanced filters, output formats | | Status Update | Change item status, add notes | | Projects | Configure projects, defaults |

Field Reference

See ./references/field-options.md for valid values.