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:

SectionPurposeExample Blocks
BrandVisual identity and messagingBrand positioning, tone of voice, visual identity
ProductWhat you're buildingProduct overview, features, glossary
UsersWho you're building forPersonas, jobs to be done
ResearchMarket and competitive landscapeCompetitors, user research
TechnicalHow it's builtTech stack, architecture, API specs
Design SystemUI components and tokensStorybook links, Figma embeds
Information ArchitectureSite structureIA trees, taxonomies
MetricsWhat you measureKPIs, north star metric, analytics events
DecisionsWhy you chose what you choseArchitecture decision records
DevelopmentWork trackingEpics, 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
  • Statusempty, draft, or complete
  • 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