{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "jetbrains-thinkrail--keep-project-intent-in-living-specs",
 "repo": "JetBrains/thinkrail",
 "repo_url": "https://github.com/JetBrains/thinkrail",
 "repo_slug": "jetbrains-thinkrail",
 "title": "Keep project intent alive across agent sessions with living specs",
 "page_title": "How to keep project intent alive across agent sessions with living specs with Thinkrail",
 "summary": "Let the agent read and maintain a connected graph of SPEC.md files beside your code.",
 "who": "A team lead whose agents forget design decisions every time a new session starts.",
 "problem": "Chat context disappears at the end of a session, so the next agent re-learns or contradicts earlier decisions.",
 "outcome": "A graph of SPEC.md files the agent searches and updates through spec tools, rendered as a tree in the workbench.",
 "steps": [
  "Open your repo with `thinkrail ~/code/my-repo`",
  "Use the bundled project setup workflow to start the spec graph",
  "Ask the agent to record decisions and intent in SPEC.md files as it works",
  "Browse the graph in the read-only Specs tool",
  "Start a new chat later and check that the agent reads the specs before changing code"
 ],
 "agent_prompt": "In JetBrains/thinkrail, set up living specs for <repo>: write SPEC.md files for the main modules with their purpose and key decisions, link them into a graph, and keep them updated as you implement <feature>.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "typescript",
 "requirements": [
  "macOS, Linux or Windows (Linux needs the GTK and WebKit libraries listed in the README)",
  "A git repository",
  "JetBrains AI sign-in or a provider connected through pi's own auth",
  "The GitHub CLI (gh) for PR workflows"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/jetbrains-thinkrail/keep-project-intent-in-living-specs/",
 "md": "https://dedupedai.com/use-cases/jetbrains-thinkrail/keep-project-intent-in-living-specs/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/jetbrains-thinkrail--keep-project-intent-in-living-specs.json",
 "api_version": "v1"
}