oat-project-reconcile

Map Git commits to planned tasks and update OAT tracking artifacts.

1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/tkstang/open-agent-toolkit --skill oat-project-reconcile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oat-project-reconcile
Source: https://github.com/tkstang/open-agent-toolkit/tree/main/.agents/skills/oat-project-reconcile
Command: npx skills add https://github.com/tkstang/open-agent-toolkit --skill oat-project-reconcile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill bridges the gap between manual code changes made outside the OAT workflow and the project's planned tasks, ensuring all work is accurately tracked and reconciled.

Core Features & Use Cases

  • Commit Mapping: Automatically maps unrecorded Git commits to corresponding tasks defined in plan.md.
  • Artifact Updates: Updates implementation.md and state.md to reflect reconciled work.
  • Human-in-the-Loop Confirmation: Requires user approval for uncertain mappings and task status changes.
  • Use Case: After a developer makes several commits directly to the repository without using OAT commands, this Skill can analyze those commits, suggest which planned tasks they fulfill, and update the project's tracking files accordingly.

Quick Start

Use the oat-project-reconcile skill to synchronize your recent manual commits with the project's planned tasks.

Frequently Asked Questions about oat-project-reconcile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reconcile manual Git commits with planned project tasks?

You can sync manual commits with project task tracking by analyzing Git history and updating OAT tracking artifacts. This tool maps commits to planned tasks using commit messages, file overlap, and temporal ordering, requiring human confirmation for uncertain assignments to keep project state accurate.

How does commit mapping work for unrecorded Git history?

Commit mapping works by analyzing Git history signals including commit messages, file overlap, and temporal ordering to match unrecorded commits to tasks defined in plan.md. It then updates implementation.md and state.md to reflect the reconciled work accurately.

Do I need OAT CLI to sync commits with the project plan?

Yes, you need OAT CLI, Git, and access to project artifacts like plan.md, implementation.md, and state.md. These dependencies are required to analyze commit history and accurately update the OAT tracking files during reconciliation.

Can I manually confirm task status changes during reconciliation?

Yes, the reconciliation process uses a human-in-the-loop confirmation mechanism. It requires your explicit approval for uncertain commit-to-task mappings and task status changes before updating the final project tracking artifacts.

What's the best way to track manual code changes outside the OAT workflow?

The best way to track manual code changes outside the OAT workflow is using a reconciliation script that bridges manual commits with planned tasks. It automatically suggests task fulfillment and updates tracking files like implementation.md accordingly.

What happens if the commit analysis cannot confidently map a commit to a task?

If commit analysis cannot confidently map a commit to a task, the Skill flags the uncertain assignment and prompts for human confirmation. This ensures no manual code changes are incorrectly attributed to planned project tasks.