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 more and better the information you give, the better the outputs will be over time. Every skill, workflow, and subagent in your Personal PM OS reads these files before producing work. Visit the Context Health screen inside mySecond at any point to see the score of each context file and continue to improve them over time. Once installed, you can also run the Enhance Context skill in Claude Code to layer in new documents — research, interview notes, competitive intel — and keep your context sharper as you learn more.