Skip to content

refactor(agent): factor CLAUDE.md to thin proxy with prompts submodule (RFC-001) #12

@CodeMonkeyCybersecurity

Description

Context

Part of the CLAUDE.md cross-repo DRY refactor (RFC-001) tracked in cybermonkey/prompts#564.

Artemis currently has a 919-line monolithic CLAUDE.md with governance contracts (testing, security, workflow, git rules, coordination) copy-pasted inline. This violates RFC-001's progressive disclosure architecture and makes governance updates a manual multi-repo operation.

Goal

Replace with a thin proxy (~60 lines) that:

  1. Imports GOVERNANCE-SUMMARY.md as the always-loaded compact ruleset (~65 rules)
  2. References full contracts via @third_party/prompts/CONTRACT.md imports
  3. Retains only artemis-specific context (bug bounty automation, Go toolchain, worker architecture, commands)

Work

  1. Add third_party/prompts git submodule:

    git submodule add ssh://git@vhost7:9001/cybermonkey/prompts.git third_party/prompts
  2. Write thin CLAUDE.md (~60 lines) containing:

    • Project purpose (bug bounty automation, distributed scanning, Go)
    • Commands (build, test, lint — from Makefile)
    • Governing contracts table with @third_party/prompts/ imports
    • Artemis-specific approach (human-centric, evidence-based, worker architecture)
    • Cross-repo work section
    • Testing: @third_party/prompts/TESTING.md + @third_party/prompts/TESTING-GO.md
  3. Once cybermonkey/prompts#562 merges, add:

    Generic anti-patterns (cross-repo): @third_party/prompts/ANTI-PATTERNS.md
    

Pattern

Same pattern applied to hecate, hera, helen. See:

  • hecate: refactor/2374-claude-md-factoring
  • hera: refactor/7-claude-md-factoring
  • helen: refactor/14-claude-md-factoring

Branch

refactor/<this-issue-number>-claude-md-factoring

References

  • RFC-001: third_party/prompts/docs/rfcs/RFC-001-governance-prompt-architecture.md (once submodule is added)
  • Tracking issue: cybermonkey/prompts#564
  • ANTI-PATTERNS.md blocker: cybermonkey/prompts#562

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions