Context overview — what your context files are and why they matter
Context files teach Claude Code everything about you so it has the information it needs to run each skill effectively.
When to use this
- You're new to mySecond and want to understand what context you'll be building
- You want to know what goes in each file
- You're improving your context after the first draft
The context files
| File | Purpose | What to include | Target size |
|---|---|---|---|
company.md | Company DNA | Mission, values, stage, market thesis, team structure, current priorities, key metrics | 800–1,500 words |
product.md | Product details | Elevator pitch, core features (top 5–7), current state, architecture, roadmap, key metrics | 500–1,200 words |
personas.md | Your users | Segments, jobs to be done, pains and gains, buying triggers, tech comfort | 300–600 words per persona |
competitors.md | Competitive landscape | Key competitors, differentiators, positioning, target customer, your moat, win themes, when they win vs. you | 250–500 words per competitor |
goals.md | Strategic priorities | Current quarter's top 3–5 goals, OKRs, success metrics, key dates and deadlines | 300–800 words |
Why it matters
| Without context | With context |
|---|---|
| "Write a PRD for a login feature" → generic template | "Write a PRD for a login feature" → references your product, users, metrics |
| "Analyze Competitor X" → surface-level comparison | "Analyze Competitor X" → positions against your actual strengths |
| "Write a status update" → fill-in-the-blank template | "Write a status update" → pulls from your goals and current priorities |
The better your context, the better your outputs. Every skill, workflow, and subagent in your PM OS reads these files before producing work. Visit the Context Health screen in mySecond to see each file's score and what to improve. You can also run the Enhance Context skill in Claude Code to fold in new documents — research, interview notes, competitive intel — as you learn more.