Intent

•
4
•

Establishes a Git-native reasoning layer within software projects, documenting the *why* behind code changes with plans, architectural decisions, and AI-readable context.

Modern software development often struggles with a 'knowledge problem,' where the context and reasoning behind architectural choices, constraints, and active plans become lost over time for both human developers and AI agents. Intent addresses this by making reasoning a first-class artifact, storing plans, decisions, constraints, and system context directly within the repository in a human-readable and machine-processable hybrid frontmatter markdown format. This ensures that the *why* behind code is tracked alongside *what* changed, making it accessible and actionable for continuous project understanding and AI-driven development workflows.

주요 기능

01Git-native storage for plans, architectural decisions, constraints, and system definitions within a `.intent/` directory.
02Integrated MCP server enables AI agents to query and interact with project intent directly during tasks.
032 GitHub stars
04Comprehensive CLI for creating, updating, listing, and validating project reasoning artifacts.
05The `review-diff` command automatically surfaces relevant project context for current Git changes.
06GitHub Action for automating the inclusion of relevant intent context in pull request comments.

사용 사례

01Documenting architectural decisions and active project plans alongside related code changes.
02Providing AI agents with focused, up-to-date project context to enhance their understanding and execution of development tasks.
03Automating code review processes by linking proposed changes to their underlying plans and decisions.