From user friction
to shipped code.
Pathmode closes the loop between product discovery and engineering delivery. Hand the approved intent to the agents that write the code, and when their pull request merges, read back a cited verdict on whether the diff did what the spec asked.
The complete discovery-to-delivery loop
Every feature traces from user friction through existing code to shipped code, and back to verification.
Evidence
Support tickets, user quotes, analytics signals
Codebase Context
Relevant files and current behavior surfaced while drafting
Intent Spec
Structured spec with outcomes and edge cases
Coding Agent
Claude Code or Cursor reads the live spec over MCP
PR Merge
The agent names the intent on the branch or PR
Graded and shipped
The merge reads the diff, grades it against the spec, and cites what it found
Evidence
Support tickets, user quotes, analytics signals
Codebase Context
Relevant files and current behavior surfaced while drafting
Intent Spec
Structured spec with outcomes and edge cases
Coding Agent
Claude Code or Cursor reads the live spec over MCP
PR Merge
The agent names the intent on the branch or PR
Graded and shipped
The merge reads the diff, grades it against the spec, and cites what it found
The loop continues: shipped features generate new evidence for the next cycle.
Read: codebase context grounds the spec
The agent already working in your repository records what it found where the change lands: the files involved, how they behave today, what a change would risk. It reads the working tree, so it sees what you have not committed yet. The spec hardens against what exists rather than what someone remembers.
- Your agent does the reading, so uncommitted work counts too
- Narrow outcomes around existing behavior instead of guessing
- Catch the case where the thing being specified half exists already
- An agent cannot turn its own notes into the standard it is graded against: you decide whether they count
- No repository connection needed for this, and no clone
Relevant Areas
Current Behavior
When a referenced pull request merges, Pathmode grades the real diff against the spec and moves the intent to shipped. The MCP server already serves outcomes and edge cases to connected agents.
Verification Suggestions
Push: the spec reaches the agent writing the code
Pathmode does not file tickets. Your tracker already does that, and a ticket is a copy that goes stale the moment the spec changes. The approved intent goes where the code actually gets written: Claude Code, Cursor, and any MCP client read the live spec, its constraints, and your constitution before they touch a file.
- 33 tools over the Pathmode MCP server, no copy-paste and no stale duplicate
- get_current_intent returns the objective, outcomes and edge cases
- get_constitution applies your standing rules to every task
- verify_implementation checks the diff against the spec that asked for it
- Works in Claude Code, Cursor, and any MCP-capable client
Objective
Users abandon signup at email verification. Make delivery reliable and offer a fallback.
Outcomes
Edge Cases
Constitution
Never add a third-party dependency for something the platform already does.
The agent reads the spec at the moment it works. Nothing to re-sync when it changes.
Pull: the merge reports back
Coding agents are told to name the intent on the branch or in the pull request, so nobody has to remember. When it merges, Pathmode reads the real diff, grades it against the spec, and cites the files it based each judgment on. Explicit failures open findings; what the diff cannot establish stays unresolved in the verdict and costs the score. The status moves to shipped as a consequence, not as the point.
The verdict answers one question: did the code do what the spec asked. Whether the spec asked for the right thing is a judgment call, and it stays yours.
Supported Reference Patterns
pathmode:<uuid>intent/<uuid>Resolves PAT-<uuid>Closes PAT-<uuid>Fixes PAT-<uuid>- Agents write the reference themselves, taught by the spec they were handed
- Fires on merge only, so drafts and open pull requests are ignored
- Every judgment cites the files it rests on, and failures open findings rather than a passing grade
- A merge still grades an intent an agent marked shipped early, so an eager status flip cannot hide the diff
- Read-only: the App never writes to your repository
Fix email verification flow
fix/email-verification → main
Implements email retry logic with SMS fallback.
Resolves PAT-abc12345-e5f6-7890-abcd-ef1234567890
Merged by @engineer · 2 commits · 4 files changed
Fix checkout email verification flow
Context Sync: always fresh
For agents that read files rather than speak MCP, one workflow pulls your workspace context from the Pathmode API and commits it to the repo. Your coding tools see current intents, constitution rules, and product strategy without anyone maintaining the files by hand.
- Generates CLAUDE.md for Claude Code and AGENTS.md for the open standard
- Generates .cursorrules for Cursor
- Generates intent.md with the active intent spec
- Plain curl against /api/v1/export, no custom action to trust
- Commits changes directly to your default branch
Add to your repo as .github/workflows/pathmode-sync.yml
name: Sync Pathmode Context
on:
schedule:
- cron: '0 6 * * 1-5' # Every weekday at 6am UTC
workflow_dispatch: # Manual trigger
permissions:
contents: write
jobs:
sync:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Pull latest Pathmode context
env:
PATHMODE_API_KEY: ${{ secrets.PATHMODE_API_KEY }}
run: |
for fmt in claude-md agents-md cursorrules intent-md; do
curl -sfSL \
-H "Authorization: Bearer $PATHMODE_API_KEY" \
-OJ "https://pathmode.io/api/v1/export?format=$fmt"
done
- uses: stefanzweifel/git-auto-commit-action@v5
with:
commit_message: 'chore: sync Pathmode context files'
file_pattern: 'CLAUDE.md AGENTS.md .cursorrules intent.md'Syncs every weekday at 6am UTC. Trigger manually from the Actions tab anytime. Needs a Pathmode API key with read scope.
Install in 2 minutes
Three steps. No config files, no tokens to paste.
Install the GitHub App
Go to Settings → Integrations in your Pathmode workspace and click "Connect GitHub." Authorize the Pathmode GitHub App for your org or account.
Pick your repository
Choose the repo Pathmode may read. It requests only what it needs: repository contents, pull requests, and webhooks.
Ground your first spec
Open an intent spec and run Implementation Context. Pathmode reads the connected repo and brings relevant code back into the draft.
The Pathmode GitHub App is read-only on your code: repository contents for Implementation Context, pull requests to detect merges, and webhooks. It never writes to your repository.
Close the loop between
discovery and delivery.
Code is downstream of intent. GitHub keeps the spec honest before and after it ships.
No credit card required · Free for solo builders