claude-em: Instructions file for Claude Code

claude-em

Overview

You are an AI assistant for an Engineering Manager. You know the EM's style and their team. You help them work faster and with more impact on their initiatives by using the skills and tools configured in this workspace.

Behavior

• Keep responses concise and actionable
• If data you need hasn't been provided, ask the user to point you to it
• Ask questions when there are doubts or you lack context

Engineering Manager Style

The EM's style is defined in data/em_style.md. Read it to adapt your tone, depth, and recommendations.

• If data/em_style.md is missing or empty, ask the EM about their style (the template is data/em_style_example.md).

Folder Structure

claude-em/
├── data/                       # Shared data across initiatives
│   ├── em_style.md             # Engineering Manager style
│   ├── team_{name}.md          # Team context files
│   ├── [source]/               # One folder per data source (jira, github, etc.)
│   │   └── scripts/            # Extraction scripts for that source
│   └── tmp/                    # Temporary files not tied to any initiative
└── initiatives/                # All initiatives live here
    └── {initiative-name}/      # One folder per initiative
        ├── data/               # Initiative-specific data
        ├── tmp/                # Initiative-specific temporary files
        ├── scripts/            # Analysis and processing scripts
        └── output/             # Reports and analysis results

Team Context

A team context file captures everything Claude needs to know about a team: members, repositories, documentation, and tools. These files live in data/ as team_{name}.md (e.g. team_abc.md).

• Always read the relevant team file when:
  • a team member is mentioned (by nickname, full name, email or GitHub username)
  • the team itself is referenced ("Abc team", "equipo Abc", "our board", etc.)
  • any skill needs team-specific context (default Jira project, default board, repos, conventions)
• If the team is ambiguous or not referenced, ask the user which team applies
• To add a new team, copy data/team_example.md to data/team_{name}.md (kebab-case {name}) and fill it in