Core Concepts
Projects & Sections
Understand how EpicContext organizes product documentation into projects, sections, and blocks.
EpicContext uses a three-level hierarchy to organize your product context: Organizations, Projects, and Sections containing Blocks.
Organizations
An organization is your team's top-level workspace. It maps to your company, department, or agency.
- Each organization can have multiple projects
- Team members are invited at the organization level
- Billing and access control are per-organization
Projects
A project represents a single product or application you're documenting. Each project gets its own set of sections and blocks.
When you create a project, EpicContext initializes it with default sections that cover the most common documentation needs.
Sections
Sections are thematic groupings of related content. EpicContext comes with these default sections:
| Section | Purpose | Example Blocks |
|---|---|---|
| Brand | Visual identity and messaging | Brand positioning, tone of voice, visual identity |
| Product | What you're building | Product overview, features, glossary |
| Users | Who you're building for | Personas, jobs to be done |
| Research | Market and competitive landscape | Competitors, user research |
| Technical | How it's built | Tech stack, architecture, API specs |
| Design System | UI components and tokens | Storybook links, Figma embeds |
| Information Architecture | Site structure | IA trees, taxonomies |
| Metrics | What you measure | KPIs, north star metric, analytics events |
| Decisions | Why you chose what you chose | Architecture decision records |
| Development | Work tracking | Epics, user stories, tasks, roadmap |
Blocks
Blocks are the atomic units of content in EpicContext. Each block has:
- Type — defines the schema (fields and structure)
- Key — a unique identifier within its section
- Name — a human-readable display name
- Status —
empty,draft, orcomplete - Value — the actual content (structured JSON)
Blocks are typed — a Persona block has different fields than a Feature block. This structured approach ensures consistency and enables smart exports.
Block Status
EpicContext tracks the completion status of every block:
- Empty — no content has been entered yet
- Draft — some content exists but required fields may be incomplete
- Complete — all required fields are filled in
The project overview page shows completion percentages per section, calculated from block statuses.
Content Flow
Your content flows through EpicContext in multiple directions:
Web Editor (forms) → Database (JSON) → Exports
├── Markdown
├── llms.txt
├── JSON API
└── CONTEXT folder
This means you write content once and it's available in every format your team and tools need.
Last updated: 2026-02-18