# Plansmith

> Plansmith is the planning agent for the business side of software. Research the problem, clarify scope, create code-aware Specs and shareable prototypes, and review readiness before handing off to your dev team in Jira, Linear, or Radial.

Plansmith reads your team's code and your business context, interviews you about what you need, and drafts a Plan made of Specs. A Spec is one buildable piece of work carrying numbered acceptance criteria (AC1, AC2, and so on), an effort size (Low, Med, High), a readiness score (Rough, Shaping, Ready), and "needs first" links that put the Plan in build order. The ontology is Team, then Project, then Plan, then Spec. Context attaches at the Team, Project, or Plan level, so later Plans can reuse the relevant business context.

Plansmith is not an issue tracker and does not replace one. Jira, Linear, and Radial are the primary handoff destinations. See the connector catalog for other destinations. Plansmith is everything that happens before the record: research, product questions, code-aware Specs, shareable prototypes, and readiness review. Resolve open questions and prototype inconsistencies before handoff.

Pricing is per user with monthly or annual billing and no free tier. Planners use full seats; teammates inside Plansmith use paid comment-only seats. Each seat is model usage, billed at what the AI providers charge, plus a stated platform share. The Pricing link under Docs below carries the full tier table, the split for each plan, the per-model prices, and what each plan includes. Developers who receive the issues in your issue tracker never need a seat, and neither do stakeholders who review a shared prototype through a public link.

The agent reads code from GitHub, GitLab, and Bitbucket with read access only, and it never changes a line. It reads business context from documents you upload, text you paste, web pages, and any source that speaks MCP.

When to use Plansmith. Reach for it when someone has a business requirement and needs it turned into work a dev team can start: scoping a feature or a migration, breaking a large project into sub-plans, writing acceptance criteria, ordering work by dependency, or getting a plan into Jira, Linear, or Radial. Reach for it before a plan exists, and reach for the issue tracker after one does. Do not use it to track work in flight, to write or change code, or to run a sprint: Plansmith terminates at the Spec and hands off.

Every page on this site is readable as text three ways, so an agent never has to parse HTML. Send `Accept: text/markdown` to any page URL and it answers in markdown. Append `.md` to any page URL for the same bytes with no header (`/pricing.md`, and `/index.md` for the home page). Append `/llms.txt` to any page URL for a scoped index of that one page: its title, its summary, its section list, and the two URLs above. This file is the index for the whole site.

How to call Plansmith from an agent. There are three doors, all documented under Developers below. The MCP server at mcp.plansmith.co is the one to reach for from a coding agent: it exposes plans and Specs as tools over Streamable HTTP. The REST API at api.plansmith.co/v1 is the general programmatic surface, described by the OpenAPI 3.1 document at /openapi.json, and GET /v1 answers without a credential so a client can discover the API before it holds one. The plansmith.co npm package is the command line. All three authenticate with a bearer credential the workspace owner mints.

## Documentation

- [Plansmith documentation](https://www.plansmith.co/docs.md): Turn a business requirement into a tree of dev-ready Specs, then push it to your issue tracker.
- [Acceptance review](https://www.plansmith.co/docs/acceptance-review.md): Check what was built against one spec, criterion by criterion, with the evidence from your code cited.
- [Agent instructions](https://www.plansmith.co/docs/agent-instructions.md): Standing decisions the agent follows in every conversation, set for you, a plan, a project or the whole company.
- [Agent tools](https://www.plansmith.co/docs/agent-tools.md): What the planning agent is allowed to do as you, and how to change it.
- [Getting started with the Plansmith API](https://www.plansmith.co/docs/api-reference.md): The base URL, how to authenticate, and the one error rule worth knowing before you start.
- [Connect a tracker or MCP connector](https://www.plansmith.co/docs/api-reference/connectors/createV1ConnectorsByConnectorIdConnect.md): 
- [Register an MCP server by URL](https://www.plansmith.co/docs/api-reference/connectors/createV1McpServers.md): 
- [Disconnect a connector](https://www.plansmith.co/docs/api-reference/connectors/deleteV1ConnectorsByConnectorIdConnect.md): 
- [Remove a registered MCP server](https://www.plansmith.co/docs/api-reference/connectors/deleteV1McpServersBySlug.md): 
- [The connector catalog, with this workspace’s connection status](https://www.plansmith.co/docs/api-reference/connectors/getV1Connectors.md): 
- [The connector’s MCP toolset](https://www.plansmith.co/docs/api-reference/connectors/getV1ConnectorsByConnectorIdToolsets.md): 
- [List this workspace’s own MCP servers](https://www.plansmith.co/docs/api-reference/connectors/getV1McpServers.md): 
- [Get a registered MCP server](https://www.plansmith.co/docs/api-reference/connectors/getV1McpServersBySlug.md): 
- [Enable or disable a connector’s MCP tools](https://www.plansmith.co/docs/api-reference/connectors/updateV1ConnectorsByConnectorIdToolsets.md): 
- [Update a registered MCP server](https://www.plansmith.co/docs/api-reference/connectors/updateV1McpServersBySlug.md): 
- [Attach a Context source to the workspace](https://www.plansmith.co/docs/api-reference/context/createV1Context.md): 
- [Re-fetch a URL-backed Context source](https://www.plansmith.co/docs/api-reference/context/createV1ContextBySourceIdRefresh.md): 
- [Upload a file as a Context source (on_conflict: keep_both | replace | skip)](https://www.plansmith.co/docs/api-reference/context/createV1ContextUpload.md): 
- [Mint a signed upload URL for a large file, then post its storage_ref](https://www.plansmith.co/docs/api-reference/context/createV1ContextUploadUrl.md): 
- [Remove a Context source](https://www.plansmith.co/docs/api-reference/context/deleteV1ContextBySourceId.md): 
- [List the Context sources for the workspace](https://www.plansmith.co/docs/api-reference/context/getV1Context.md): 
- [Get a Context source](https://www.plansmith.co/docs/api-reference/context/getV1ContextBySourceId.md): 
- [Download a Context source’s original file, byte for byte](https://www.plansmith.co/docs/api-reference/context/getV1ContextBySourceIdFile.md): 
- [Download the workspace's Context as a zip archive](https://www.plansmith.co/docs/api-reference/context/getV1ContextDownload.md): 
- [Mint an API key (the secret is returned once)](https://www.plansmith.co/docs/api-reference/credentials/createV1ApiKeys.md): 
- [Revoke one of your API keys](https://www.plansmith.co/docs/api-reference/credentials/deleteV1ApiKeysByKeyId.md): 
- [Disconnect an app and kill its tokens](https://www.plansmith.co/docs/api-reference/credentials/deleteV1OauthConnectionsByGrantId.md): 
- [List your API keys in this workspace](https://www.plansmith.co/docs/api-reference/credentials/getV1ApiKeys.md): 
- [List the apps you have connected](https://www.plansmith.co/docs/api-reference/credentials/getV1OauthConnections.md): 
- [Run a document collaboration command using the shared service contract](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1DocumentCollaboration.md): 
- [Propose an exact native edit or an external change](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1DocumentsByDocumentIdSuggestions.md): 
- [Accept, reject, withdraw or record external application](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1DocumentsByDocumentIdSuggestionsBySuggestionId.md): 
- [Start a document discussion](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1DocumentsByDocumentIdThreads.md): 
- [Reply without changing the thread resolution](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1DocumentsByDocumentIdThreadsByThreadIdComments.md): 
- [Mark notifications read through a viewed watermark](https://www.plansmith.co/docs/api-reference/document-collaboration/createV1NotificationsReadAll.md): 
- [Resolve a canonical document from its typed target](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1Documents.md): 
- [Find teammates who can read this discussion](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdMentionCandidates.md): 
- [List document suggestions in a discussion plan](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdSuggestions.md): 
- [Read a suggestion, current source and review capabilities](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdSuggestionsBySuggestionId.md): 
- [Read immutable suggestion revisions and decisions](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdSuggestionsBySuggestionIdHistory.md): 
- [List document discussion threads](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdThreads.md): 
- [Read a thread and its first page of comments](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdThreadsByThreadId.md): 
- [Read the next page of replies](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdThreadsByThreadIdComments.md): 
- [Read immutable comment history subject to current permissions](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1DocumentsByDocumentIdThreadsByThreadIdCommentsByCommentIdHistory.md): 
- [Read your Inbox with current document access checks](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1Notifications.md): 
- [Read one of your notifications with current access checks](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1NotificationsByNotificationId.md): 
- [Read your email notification preferences](https://www.plansmith.co/docs/api-reference/document-collaboration/getV1NotificationsPreferences.md): 
- [Follow, unfollow or mute this thread](https://www.plansmith.co/docs/api-reference/document-collaboration/setV1DocumentsByDocumentIdThreadsByThreadIdSubscription.md): 
- [Revise or explicitly refresh a pending suggestion](https://www.plansmith.co/docs/api-reference/document-collaboration/updateV1DocumentsByDocumentIdSuggestionsBySuggestionId.md): 
- [Resolve, reopen or explicitly reattach a thread](https://www.plansmith.co/docs/api-reference/document-collaboration/updateV1DocumentsByDocumentIdThreadsByThreadId.md): 
- [Edit, delete or moderate a comment with a version check](https://www.plansmith.co/docs/api-reference/document-collaboration/updateV1DocumentsByDocumentIdThreadsByThreadIdCommentsByCommentId.md): 
- [Mark your notification read or unread](https://www.plansmith.co/docs/api-reference/document-collaboration/updateV1NotificationsByNotificationId.md): 
- [Change your email preferences without disabling Inbox mentions](https://www.plansmith.co/docs/api-reference/document-collaboration/updateV1NotificationsPreferences.md): 
- [Reset the workspace format to the built-in](https://www.plansmith.co/docs/api-reference/formats/deleteV1FormatsByKind.md): 
- [The resolved Spec or Epic format, with its source tier](https://www.plansmith.co/docs/api-reference/formats/getV1FormatsByKind.md): 
- [Set the workspace’s Spec or Epic format (owner only)](https://www.plansmith.co/docs/api-reference/formats/setV1FormatsByKind.md): 
- [API index, plus the identity of the calling credential when one is sent](https://www.plansmith.co/docs/api-reference/identity/getV1.md): 
- [Who this credential is, and what it can do](https://www.plansmith.co/docs/api-reference/identity/getV1Me.md): 
- [Restore an earlier version of your own instructions](https://www.plansmith.co/docs/api-reference/instructions/createV1InstructionsMeVersionsBySeqRestore.md): 
- [Restore an earlier version of the workspace-wide instructions (owner only)](https://www.plansmith.co/docs/api-reference/instructions/createV1InstructionsVersionsBySeqRestore.md): 
- [Remove the workspace-wide instructions (owner only)](https://www.plansmith.co/docs/api-reference/instructions/deleteV1Instructions.md): 
- [Remove your own instructions](https://www.plansmith.co/docs/api-reference/instructions/deleteV1InstructionsMe.md): 
- [The workspace-wide instructions the agent is given every turn](https://www.plansmith.co/docs/api-reference/instructions/getV1Instructions.md): 
- [Your own instructions (the id comes from the credential, never the URL)](https://www.plansmith.co/docs/api-reference/instructions/getV1InstructionsMe.md): 
- [Every version of your own instructions](https://www.plansmith.co/docs/api-reference/instructions/getV1InstructionsMeVersions.md): 
- [Every version of the workspace-wide instructions, newest first](https://www.plansmith.co/docs/api-reference/instructions/getV1InstructionsVersions.md): 
- [Replace the workspace-wide instructions (owner only)](https://www.plansmith.co/docs/api-reference/instructions/setV1Instructions.md): 
- [Replace your own instructions](https://www.plansmith.co/docs/api-reference/instructions/setV1InstructionsMe.md): 
- [Re-fetch a URL-backed Context source](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugContextBySourceIdRefresh.md): 
- [Restore an earlier version of this project’s instructions](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugInstructionsVersionsBySeqRestore.md): 
- [Attach a Context source to a plan](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdContext.md): 
- [Re-fetch a URL-backed Context source](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdContextBySourceIdRefresh.md): 
- [Copy another plan's own Context onto this plan](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdContextCopy.md): 
- [Upload a file as a Context source (on_conflict: keep_both | replace | skip)](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdContextUpload.md): 
- [Mint a signed upload URL for a large file, then post its storage_ref](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdContextUploadUrl.md): 
- [Add a needs-first edge between plans](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdDependencies.md): 
- [Add an image to a plan, optionally appended to a spec or the epic](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdImages.md): 
- [Mint a signed upload URL for an image over 4 MB, then post its storage_ref](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdImagesUploadUrl.md): 
- [Restore an earlier version of this plan’s instructions](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdInstructionsVersionsBySeqRestore.md): 
- [Add a prototype comment](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeComments.md): 
- [Rebuild the prototype from its screen sources with the template now in force](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeReassemble.md): 
- [Mint or rotate a public link (owner only)](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeShares.md): 
- [Push a plan and its Specs to the connected tracker](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdPush.md): The response carries `push.belowReady`: every spec in the plan
- [Share a plan with a workspace member](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdSharingCollaborators.md): 
- [Add a Spec to a plan](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdSpecs.md): 
- [Promote a Spec subtree into its own sub-plan](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortIdPromote.md): 
- [Remove a Context source](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdContextBySourceId.md): 
- [Remove a needs-first edge](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdDependenciesByEdgeId.md): 
- [Remove this plan’s instructions](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdInstructions.md): 
- [Delete a comment](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeCommentsByCommentId.md): 
- [Revoke every public link for this plan](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeShares.md): 
- [Remove a collaborator](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdSharingCollaboratorsByUserId.md): 
- [Delete a Spec](https://www.plansmith.co/docs/api-reference/plans/deleteV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortId.md): 
- [Download a Context source’s original file, byte for byte](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugContextBySourceIdFile.md): 
- [List the Context sources for a plan](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdContext.md): 
- [Get a Context source](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdContextBySourceId.md): 
- [Download a Context source’s original file, byte for byte](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdContextBySourceIdFile.md): 
- [Download a plan's Context as a zip archive](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdContextDownload.md): 
- [Read a plan’s epic](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdEpic.md): 
- [Export a plan as markdown, CSV, JSON, or the pull index](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdExport.md): 
- [This plan’s own instructions](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdInstructions.md): 
- [Every version of this plan’s instructions](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdInstructionsVersions.md): 
- [Get the plan’s clickable prototype](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdPrototype.md): 
- [List prototype comments](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeComments.md): 
- [List live public links for this prototype](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeShares.md): 
- [What has been pushed, and what changed since](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdPushStatus.md): 
- [Who this plan is shared with (owner only)](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdSharing.md): 
- [List collaborators (owner only)](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdSharingCollaborators.md): 
- [Get a spec, including its numbered acceptance criteria, or one section of it](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortId.md): 
- [Get a spec’s outline: headings, open questions and criteria with their lines](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortIdOutline.md): 
- [Get a plan with every Spec, sub-plan and dependency in one call](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdTree.md): 
- [Replace a plan’s epic](https://www.plansmith.co/docs/api-reference/plans/setV1ProjectsByProjectSlugPlansByPlanShortIdEpic.md): 
- [Replace this plan’s instructions](https://www.plansmith.co/docs/api-reference/plans/setV1ProjectsByProjectSlugPlansByPlanShortIdInstructions.md): 
- [Make a plan private or visible to the whole workspace](https://www.plansmith.co/docs/api-reference/plans/setV1ProjectsByProjectSlugPlansByPlanShortIdSharingVisibility.md): 
- [Resolve or reopen a comment](https://www.plansmith.co/docs/api-reference/plans/updateV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeCommentsByCommentId.md): 
- [Change a collaborator’s role](https://www.plansmith.co/docs/api-reference/plans/updateV1ProjectsByProjectSlugPlansByPlanShortIdSharingCollaboratorsByUserId.md): 
- [Update a Spec](https://www.plansmith.co/docs/api-reference/plans/updateV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortId.md): 
- [Create a project](https://www.plansmith.co/docs/api-reference/projects/createV1Projects.md): 
- [Attach a Context source to a project](https://www.plansmith.co/docs/api-reference/projects/createV1ProjectsByProjectSlugContext.md): 
- [Upload a file as a Context source (on_conflict: keep_both | replace | skip)](https://www.plansmith.co/docs/api-reference/projects/createV1ProjectsByProjectSlugContextUpload.md): 
- [Mint a signed upload URL for a large file, then post its storage_ref](https://www.plansmith.co/docs/api-reference/projects/createV1ProjectsByProjectSlugContextUploadUrl.md): 
- [Create a plan, or a sub-plan under an existing one](https://www.plansmith.co/docs/api-reference/projects/createV1ProjectsByProjectSlugPlans.md): 
- [Remove a Context source](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugContextBySourceId.md): 
- [Reset this project’s format (owner only)](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugFormatsByKind.md): 
- [Remove this project’s instructions](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugInstructions.md): 
- [Delete a plan](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugPlansByPlanShortId.md): 
- [Delete a project skill](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugSkillsBySlug.md): 
- [List projects](https://www.plansmith.co/docs/api-reference/projects/getV1Projects.md): 
- [Get a project](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlug.md): 
- [List the Context sources for a project](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugContext.md): 
- [Get a Context source](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugContextBySourceId.md): 
- [Download a project's Context as a zip archive](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugContextDownload.md): 
- [The format resolved for this project](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugFormatsByKind.md): 
- [This project’s instructions, given to the agent in every plan here](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugInstructions.md): 
- [Every version of this project’s instructions](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugInstructionsVersions.md): 
- [List the plans you can see in a project](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugPlans.md): 
- [Get a plan and its epic](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugPlansByPlanShortId.md): 
- [List a project’s skills](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugSkills.md): 
- [Read a project skill](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugSkillsBySlug.md): 
- [Set this project’s format (owner only)](https://www.plansmith.co/docs/api-reference/projects/setV1ProjectsByProjectSlugFormatsByKind.md): 
- [Replace this project’s instructions](https://www.plansmith.co/docs/api-reference/projects/setV1ProjectsByProjectSlugInstructions.md): 
- [Write a project skill](https://www.plansmith.co/docs/api-reference/projects/setV1ProjectsByProjectSlugSkillsBySlug.md): 
- [Rename a project](https://www.plansmith.co/docs/api-reference/projects/updateV1ProjectsByProjectSlug.md): 
- [Rename, re-parent, or move a plan through its lifecycle](https://www.plansmith.co/docs/api-reference/projects/updateV1ProjectsByProjectSlugPlansByPlanShortId.md): 
- [Remove this project’s prototype template, back to the company’s or the built-in](https://www.plansmith.co/docs/api-reference/prototype-template/deleteV1ProjectsByProjectSlugPrototypeTemplate.md): 
- [Remove the workspace prototype template, back to the built-in](https://www.plansmith.co/docs/api-reference/prototype-template/deleteV1PrototypeTemplate.md): 
- [The prototype template in force for this project: its own, the](https://www.plansmith.co/docs/api-reference/prototype-template/getV1ProjectsByProjectSlugPrototypeTemplate.md): 
- [The prototype template in force for the workspace, with its source tier](https://www.plansmith.co/docs/api-reference/prototype-template/getV1PrototypeTemplate.md): 
- [Set this project’s prototype template; validated before it is stored](https://www.plansmith.co/docs/api-reference/prototype-template/setV1ProjectsByProjectSlugPrototypeTemplate.md): 
- [Set the workspace’s prototype template (owner only); validated before it](https://www.plansmith.co/docs/api-reference/prototype-template/setV1PrototypeTemplate.md): 
- [Delete a workspace skill (owner only)](https://www.plansmith.co/docs/api-reference/skills/deleteV1SkillsBySlug.md): 
- [List skills (built-in and workspace)](https://www.plansmith.co/docs/api-reference/skills/getV1Skills.md): 
- [Read a workspace skill](https://www.plansmith.co/docs/api-reference/skills/getV1SkillsBySlug.md): 
- [Write a workspace skill (owner only)](https://www.plansmith.co/docs/api-reference/skills/setV1SkillsBySlug.md): 
- [This document, describing every endpoint](https://www.plansmith.co/docs/api-reference/spec/getV1OpenapiJson.md): 
- [Move usage between people, or to and from the shared pool](https://www.plansmith.co/docs/api-reference/usage/createV1UsageTransfer.md): 
- [What moving usage would do, to both people](https://www.plansmith.co/docs/api-reference/usage/createV1UsageTransferQuote.md): 
- [Usage by person, role-filtered (owners see everyone)](https://www.plansmith.co/docs/api-reference/usage/getV1Usage.md): 
- [Invite someone to the workspace](https://www.plansmith.co/docs/api-reference/workspace/createV1Invites.md): 
- [Revoke a pending invite](https://www.plansmith.co/docs/api-reference/workspace/deleteV1InvitesByInviteId.md): 
- [Remove a member (name a successor if they own plans)](https://www.plansmith.co/docs/api-reference/workspace/deleteV1MembersByUserId.md): 
- [List pending invites](https://www.plansmith.co/docs/api-reference/workspace/getV1Invites.md): 
- [List the members of this workspace](https://www.plansmith.co/docs/api-reference/workspace/getV1Members.md): 
- [Change a member’s role](https://www.plansmith.co/docs/api-reference/workspace/updateV1MembersByUserId.md): 
- [Audit log](https://www.plansmith.co/docs/audit-log.md): A record of the consequential things that happened in your workspace, readable by owners.
- [Billing and usage](https://www.plansmith.co/docs/billing-and-usage.md): The three plans, what counts as usage, and how to add more when you run low.
- [Canvases](https://www.plansmith.co/docs/canvases.md): The agent sketches, you correct the sketch, the prototype proves it.
- [Comments and suggested edits](https://www.plansmith.co/docs/comments-and-suggestions.md): Discuss a document, propose a change, and bring the right people into the conversation.
- [Connecting a repository](https://www.plansmith.co/docs/connecting-a-repository.md): Ground your specs in the code your team actually has. Read-only, GitHub, GitLab and Bitbucket.
- [Context sources](https://www.plansmith.co/docs/context-sources.md): The documents the agent reads before it plans: what to attach, at which level, and how inheritance works.
- [Core concepts](https://www.plansmith.co/docs/core-concepts.md): Team, Project, Plan and Spec: the four words every other page in these docs uses.
- [Deployment options](https://www.plansmith.co/docs/deployment-options.md): Where Plansmith runs, and how it reads a Git server that only answers inside your network.
- [Plansmith for developers](https://www.plansmith.co/docs/developers.md): The three developer surfaces, how they authenticate, and which one to reach for.
- [Plansmith API](https://www.plansmith.co/docs/developers/api.md): A versioned JSON API at api.plansmith.co/v1, authenticated with a bearer credential.
- [Plansmith self-hosted Git broker](https://www.plansmith.co/docs/developers/broker.md): Let Plansmith read a Git server inside your network, without opening a firewall port and without giving us your credentials.
- [Build a skill around a plan](https://www.plansmith.co/docs/developers/build-a-skill.md): Use the Plansmith CLI to give a coding agent a repeatable, checked plan-to-delivery workflow.
- [Plansmith CLI](https://www.plansmith.co/docs/developers/cli.md): Plan, spec, and push from your terminal. Zero dependencies, every command scriptable.
- [Plansmith MCP server](https://www.plansmith.co/docs/developers/mcp.md): Give a coding agent the plan it is meant to build from, with document discussions, suggestions and notification tools.
- [Enterprise features](https://www.plansmith.co/docs/enterprise.md): What an Enterprise plan includes, how your Git server stays in your network, and what buying one involves.
- [Epic writer](https://www.plansmith.co/docs/epic-writer.md): How the agent writes your plan's epic, and how to extend it for your team.
- [Extending a skill](https://www.plansmith.co/docs/extending-a-skill.md): Add your team's rules to a skill Plansmith already runs, without rewriting it.
- [Spec and Epic formats](https://www.plansmith.co/docs/formats.md): The sections every Spec and Epic is written to, and how to replace ours with your own.
- [Images in documents](https://www.plansmith.co/docs/images-in-documents.md): Put screenshots and mockups where a spec or a context document needs them.
- [Import from your issue tracker](https://www.plansmith.co/docs/import-from-your-issue-tracker.md): Bring existing Jira work into a plan, refine it with the agent, and push it back to the same issues.
- [Instructions, skills or formats?](https://www.plansmith.co/docs/instructions-skills-or-formats.md): Three ways to make the agent work the way your team works, and which one you want.
- [Members and roles](https://www.plansmith.co/docs/members-and-roles.md): Who is in your workspace, what each role can do, and what happens to someone's plans when they leave.
- [Plan lifecycle](https://www.plansmith.co/docs/plan-lifecycle.md): The five states a plan moves through, what moves it, and why you cannot set them freely.
- [Planning with the agent](https://www.plansmith.co/docs/planning-with-the-agent.md): How the conversation works, why it researches before it asks, and how to correct a Spec.
- [Prototype template](https://www.plansmith.co/docs/prototype-template.md): The frame every prototype is assembled into, and how to replace ours with your own for a company or a project.
- [Prototypes](https://www.plansmith.co/docs/prototypes.md): Turn a plan into a clickable mockup you can share, comment on, and send back to the agent.
- [Push to your issue tracker](https://www.plansmith.co/docs/push-to-your-issue-tracker.md): Send the plan to Linear, Jira or Radial, with its hierarchy and dependencies intact.
- [Quickstart](https://www.plansmith.co/docs/quickstart.md): From a business requirement to a plan in your issue tracker, in about five minutes.
- [Readiness review](https://www.plansmith.co/docs/readiness-review.md): Score how build-ready one spec is, get the gaps as questions you answer and fixes you approve, and keep the findings in a file.
- [Sharing a plan](https://www.plansmith.co/docs/sharing-a-plan.md): Plans are private until you share them. Who can see one, who can edit it, and the one link that sits outside the rules.
- [Skills](https://www.plansmith.co/docs/skills.md): Short playbooks that teach the agent how your team does a particular job, read when they are relevant.
- [Spec writer](https://www.plansmith.co/docs/spec-writer.md): How the agent writes each spec, and how to extend it for your team.
- [Sub-plans and dependencies](https://www.plansmith.co/docs/sub-plans-and-dependencies.md): When work belongs in this plan, when it needs its own sub-plan, and how to say one thing needs another first.
- [What is Plansmith](https://www.plansmith.co/docs/what-is-plansmith.md): Plansmith turns a business requirement into a tree of dev-ready Specs, then pushes them to your issue tracker.
- [Changelog](https://www.plansmith.co/docs/changelog.md): every release, newest first, in full. Not year-scoped like the web page.
- [Full corpus](https://www.plansmith.co/llms-full.txt): every documentation page and every published blog post, concatenated, for one-request ingestion.

## Blog

- [The Plansmith blog](https://www.plansmith.co/blog.md): every published post with its date and summary. Each post has a `.md` twin and a scoped `llms.txt`.
- [Plansmith blog RSS feed](https://www.plansmith.co/blog/feed.xml): RSS 2.0, carrying the FULL text of each post in content:encoded rather than a teaser.

## Developers

- [Plansmith developer surfaces](https://www.plansmith.co/docs/developers.md): the three doors (API, MCP server, CLI), how each authenticates, and which one to reach for.
- [Plansmith API reference](https://www.plansmith.co/docs/developers/api.md): the REST API at api.plansmith.co/v1: bearer auth, scopes, pagination, and the error envelope.
- [Plansmith OpenAPI spec](https://www.plansmith.co/openapi.json): OpenAPI 3.1 for the whole REST API, with an operationId and a typed response on every operation. Also at api.plansmith.co/v1/openapi.json.
- [Plansmith MCP server](https://www.plansmith.co/docs/developers/mcp.md): plans and Specs as tools over Streamable HTTP at mcp.plansmith.co. Hosted is read-only; the local server adds the write tools.
- [Plansmith CLI](https://www.plansmith.co/docs/developers/cli.md): the plansmith.co npm package: plan, spec and push from a terminal.
- [Plansmith self-hosted Git broker](https://www.plansmith.co/docs/developers/broker.md): let Plansmith read a Git server inside your network with no inbound firewall rule.
- [Plansmith API endpoint reference](https://www.plansmith.co/docs/api-reference.md): one page per endpoint, generated from the OpenAPI document.

## Reference

- [Pricing](https://www.plansmith.co/pricing.md): tiers, prices, model usage at cost and the platform share, per-model prices, comment-only seats, and what each plan includes.
- [Brand](https://www.plansmith.co/brand.md): colors, typography, voice, and locked terminology, in agent-readable form.

## Site

- [Home](https://www.plansmith.co/index.md): what Plansmith does, the four planning steps, and the connector map.
- [Product](https://www.plansmith.co/product.md): the full tour of Context, Clarity, and Collaboration, with product screens.
- [Pricing](https://www.plansmith.co/pricing.md): the three tiers, the compare table, and the plan questions.
- [Connectors](https://www.plansmith.co/connectors.md): connectors grouped by the job they do, context in and handed off to.
- [About Plansmith](https://www.plansmith.co/about.md): who builds Plansmith, why, what the company believes, its investors, and how it handles customer data.
- [The cost of poor planning](https://www.plansmith.co/roi.md): the value model: four cost centres against the seats, with the worked example and the sensitivity grid.

## Connectors

- [Linear](https://www.plansmith.co/connectors/linear.md): what a Plan becomes in Linear, with the full mapping table.
- [Jira](https://www.plansmith.co/connectors/jira.md): what a Plan becomes in Jira, with the full mapping table.
- [Asana](https://www.plansmith.co/connectors/asana.md): what a Plan becomes in Asana, with the full mapping table.
- [Radial](https://www.plansmith.co/connectors/radial.md): what a Plan becomes in Radial, with the full mapping table.

## Optional

- [Book a demo](https://www.plansmith.co/book-a-demo.md): bring real business requirements from your backlog and we plan them live.
- [Brand guidelines](https://www.plansmith.co/brand.md): the visual brand page the machine-readable files derive from.
- [Privacy](https://www.plansmith.co/privacy.md): how Plansmith handles your data.
- [Terms](https://www.plansmith.co/terms.md): the terms of service.