The product context layer for your AI agent.

## UltiPad product sync (MCP: ultipad)

### One-time setup — resolve your product
list_products → pick the product for this repo. Record it here and reuse for every call:
  This repo → product: <NAME>, productId: <ID>

### GATE 1 — STOP before writing any code or editing any file
Do these steps first, every time:
1. search_ideas — find if an idea exists for this work.
2. If no match: create_idea(title, description, ideaType, productIds:[<ID>]). Note the ideaId.
3. report_dev_progress(ideaId, "started", agentModel, sessionId)
If idea has an approved spec: get_agent_spec(ideaId) and implement against it.

### GATE 2 — immediately after every git commit (before anything else)
```
git show --shortstat <sha>   # get additions/deletions/filesChanged
add_commit_ref(ideaId, sha, message, additions, deletions, filesChanged,
               agentModel="<your-model-id>", sessionId="<session-id>")
```
One call per commit. Do not batch. Do not defer.

### While building (ongoing)
- add_user_story(ideaId) — acceptance criteria as they firm up
- update_idea_details(ideaId, functionalSpecs/notes/targetOutcomes)
- update_idea_scores(ideaId, impact, effort, confidence) — scale: 0 1 2 3 5 8 13 20 40 100
- get_product_overview + get_roadmap — read strategy before major decisions

### GATE 3 — after shipping
report_dev_progress(ideaId, "completed", agentModel, sessionId)
set_idea_stage(ideaId, "Done")
update_idea_state(ideaId, "approved") if user approved the work.
Never write to another product's roadmap.

// .claude/settings.json (in your repo) — deterministic reminder so the agent
// never forgets to record commits against UltiPad ideas.
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command // empty' | grep -q 'git commit' && echo 'REMINDER: record this commit on its UltiPad idea via the ultipad MCP add_commit_ref tool (sha + message + webUrl + additions/deletions from git show --shortstat).' || true"
          }
        ]
      }
    ]
  }
}