# Plansmith > Plansmith is the planning agent. It turns business requirements into build-ready Specs and pushes them to your issue tracker in one click. It is built for the people who decide what gets built and hand the work to a dev team. 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 every Plan after the first one starts smarter. Plansmith is not an issue tracker and does not replace one. Linear, Jira, Asana, and Radial are where a dev team works and where the plan of record lives. Plansmith is everything that happens before the record: the interview, the scoring, the build order, the question settled before anyone builds. Push is one way. Pricing is per user, per month, with no free tier. The Pricing link under Docs below carries the full tier table, the credit allowances, 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 Linear, Jira, Asana, 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. - [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): - [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): - [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): - [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): - [Re-fetch a URL-backed Context source](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugContextBySourceIdRefresh.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): - [Add a needs-first edge between plans](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdDependencies.md): - [Add a prototype comment](https://www.plansmith.co/docs/api-reference/plans/createV1ProjectsByProjectSlugPlansByPlanShortIdPrototypeComments.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): - [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): - [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): - [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): - [Read a plan’s epic](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdEpic.md): - [Export a plan as markdown, CSV or JSON](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdExport.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](https://www.plansmith.co/docs/api-reference/plans/getV1ProjectsByProjectSlugPlansByPlanShortIdSpecsBySpecShortId.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): - [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): - [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](https://www.plansmith.co/docs/api-reference/projects/deleteV1ProjectsByProjectSlugFormatsByKind.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): - [The format resolved for this project](https://www.plansmith.co/docs/api-reference/projects/getV1ProjectsByProjectSlugFormatsByKind.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](https://www.plansmith.co/docs/api-reference/projects/setV1ProjectsByProjectSlugFormatsByKind.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): - [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): - [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. - [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. - [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. Hosted is read-only; the local server adds the write 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. - [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. - [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. - [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. - [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 documentation](https://www.plansmith.co/llms-full.txt): every documentation page concatenated, for one-request ingestion. ## 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, credit allowances, 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. - [Why Plansmith](https://www.plansmith.co/why.md): the argument for giving the plan an agent, and what Plansmith refuses to do. ## 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.