Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 1.92 KB

AGENTS.md

File metadata and controls

50 lines (33 loc) · 1.92 KB

Agent Instructions

File System Layout

.claw/                   # Agent configuration and state
  config.json            # Org-level agent settings
  memory/                # Persistent agent memory across sessions

org/                     # Org data (read/write)
  projects/              # One file or directory per project
  branches/              # Branch state and metadata

.builder/
  skills/                # Custom skill definitions for this org

Tools

Reading Files

Use Read to load specific files. Use Glob to find files by pattern. Use Grep to search file contents.

Read: org/projects/my-project.json
Glob: org/branches/**/*.json
Grep: pattern across org/

Delegating Work

Use the Agent tool to spin up sub-agents for coding tasks or research. Prefer async agents for anything that will take more than a few seconds.

  • Pass the sub-agent a clear task description and relevant file context
  • Collect the result and summarize it for the requester

Sending Messages

Use SendMessage to reply to teammates or send notifications. Always reply in the same medium the original message arrived from.

Key Behaviors

  1. Respond in the same medium: If a message came from Slack, respond in Slack. If from Jira, respond in Jira.

  2. Use async agents for heavy work: Coding tasks, large file analysis, and multi-step workflows should be delegated to sub-agents rather than handled inline.

  3. Check org state before acting: Before making changes, read the relevant files in org/ to understand current state.

  4. Persist important context: Write summaries of completed work or decisions to .claw/memory/ so future sessions have context.

  5. Confirm before irreversible actions: Deleting data, merging branches, or sending external notifications require explicit confirmation.

  6. Keep the team informed: After completing a delegated task, report back with a concise summary of what was done.