.forma.md
Forma
Markdown-backed workspace content.
A files-first workspace for turning everyday Markdown into durable, shared context for people and AI Agents.
Forma keeps product direction, research, decisions, operating knowledge, and project records in the repository where that work already happens. Markdown files and explicit workspace configuration remain the source of truth: readable in ordinary editors, reviewable through Git, and available without a hidden content store.
What Forma brings to Markdown
- Durable source material. Keep knowledge as versioned files instead of importing it into a proprietary database.
- Explicit structure. Define spaces, schemas, semantic types, templates, and Views that fit the work rather than a fixed application model.
- Connected context. Resolve links, surface relationships, and use diagnostics to make missing, stale, or inconsistent knowledge visible.
- Multiple useful surfaces. Read and navigate the same workspace through the CLI, editor integrations, and a lightweight WebApp without making any interface the owner of the content.
- A reliable foundation for Agents. Give people and Agents stable paths, declared structure, and reviewable changes instead of asking them to infer intent from an unstructured file tree.
How it works
- Write ordinary Markdown and keep it in the repository.
- Describe the parts that benefit from structure with small, explicit Forma configuration.
- Use the resulting entries, references, health checks, and Views to read, maintain, and reuse the workspace with confidence.
Get started
Forma is available as a Public Preview for macOS, Linux, and Windows.
- Visit the Choral Forma repository for source code, releases, and issue tracking.
- Follow the installation instructions to install the Forma CLI.
- Browse the committed example workspaces, from the minimal workspace to the guided getting-started workspace and the copyable software product R&D workspace.
- Share preview feedback through GitHub Issues.
After installing the CLI, bootstrap and open a workspace with:
forma init --name "My Workspace"
forma check
forma serve
Explore this project
- Read the product direction for the current product intent.
- Read the Forma product definition for its principles, scope, and architecture.
- Open the configured Views and Browse sections to explore this repository through its existing workspace projections.
This workspace
This repository dogfoods Forma while it is being built. Its knowledge/ directory is one configurable workspace, not a required template for every future Forma user.
The frontmatter in this document configures the workspace. Its Markdown body is the public root introduction, rendered by both the local WebApp and the static site export without becoming a separate CMS record.