# BRIEF.md

> Use this tool when you need to capture and manage project intent, decisions, and constraints in a lightweight and persistent manner. It solves problems of project knowledge management, collaboration, and consistency across various domains, including software, research, and business. The tool provides read/write access to BRIEF.md files through a stdio transport interface, allowing for seamless integration and management of project information.

Canonical page: https://skillsregistry.net/skills/brief-md  
JSON: https://api.skillsregistry.net/v1/skills/brief-md

## Description

BRIEF.md is an open specification for a lightweight Markdown file that captures project intent — decisions, constraints, and open questions — in a persistent file at the project root. This MCP server provides 57 tools for full read/write access to BRIEF.md files, including workspace and session management, context reads/writes, validation and conflict detection, hierarchy navigation, an ontology system for domain knowledge packs, references management, and type guide extensions. It uses stdio transport, spawned as a local subprocess by the MCP client, and works across software, research, creative, and business domains.

## Trust

- **Trust score (0–1):** 0.66
- **Verification tier:** scanned
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** search
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/brief-md)
- **Repository:** <https://github.com/brief-md/brief-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "brief-md"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/brief-md` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/brief-md/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt