devloop-audit

Devloop Audit

Audit devloop against Claude Code's evolving capabilities.

When to Run

• After major Claude Code releases
• Monthly maintenance check
• When noticing new Claude Code features

Audit Process

Step 1: Gather Claude Code Information

1. Fetch Release Notes: https://code.claude.com/docs/en/changelog.md
2. Review Key Docs: Skills, Plugins, Hooks, Sub-agents at code.claude.com/docs/en/

Step 2: Analyze Current devloop

ls plugins/devloop/agents/
ls plugins/devloop/skills/

Step 3: Compare and Identify Gaps

Category	Questions
Overlap	Does native Claude Code now provide this?
Enhancement	Can new features improve this?
Deprecation	Are we using outdated patterns?
Missing	New capabilities to adopt?

Step 4: Generate Findings Report

Priority Ranking:

• High: Native feature replaces devloop, security issue, blocks users
• Medium: Partial overlap, improves UX, aligns with best practices
• Low: Minor improvement, nice-to-have

Effort Estimation:

• Low: <1 day, localized change
• Medium: 1-3 days, multiple files
• High: 3+ days, architectural change

Save to .devloop/spikes/claude-code-audit-YYYY-MM-DD.md:

# Claude Code Audit Findings

**Date**: YYYY-MM-DD
**Claude Code Version**: X.Y.Z
**devloop Version**: X.Y.Z

## Summary
Brief overview.

## Integration Opportunities

### High Priority
| Finding | Current State | Action | Effort |
|---------|--------------|--------|--------|

### Medium Priority
...

## Deprecated Patterns
| Pattern | Native Alternative | Migration |
|---------|-------------------|-----------|

## New Features to Adopt
| Feature | Use Case | Notes |
|---------|----------|-------|

Step 5: Offer Next Steps

AskUserQuestion:
  questions:
    - question: "Audit complete. What next?"
      header: "Action"
      options:
        - label: "Create spike from findings"
        - label: "Create plan from findings"
        - label: "Review findings"

Audit Checklist

• Commands: State detection, run patterns, ship workflow current?
• Skills: Standard frontmatter, discoverable by Claude?
• Agents: Standard format, aligned with Agent tool?
• Hooks: Current API, best practices?
• Task Management: Plan vs session tasks clear?
• State: .devloop/ structure current?

Key Documentation Links

• Full Index: https://code.claude.com/docs/llms.txt
• Skills: https://code.claude.com/docs/en/skills
• Plugins: https://code.claude.com/docs/en/plugins
• Hooks: https://code.claude.com/docs/en/hooks
• Sub-agents: https://code.claude.com/docs/en/sub-agents

Output

Produces:

1. Findings report at .devloop/spikes/claude-code-audit-YYYY-MM-DD.md
2. Summary of integration opportunities
3. Option to create spike/plan for follow-up