sync-tasks
/sync-tasks
Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.
Original author description
Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.
How it works
- Stay read-only
- Establish the project and task snapshot
- Inspect repository evidence in this order
- Classify the mapping
- Report without applying
SKILL.md preview
--- name: sync-tasks description: Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only. disable-model-invocation: true --- # Sync Tasks Build an evidence-backed reconciliation report. Use the `kotgent` CLI for tracker reads and `git` plus ordinary file inspection for repository evidence. Do not use an MCP server, SDK, direct daemon request, or helper script. ## Stay read-only Do not run `task add`, `task claim`, `task comment`, `task review`, `task done`, `task unlink`, `task move`, `task dep`, `task delete`, `project init`, `project delete`, or `project restore`. Do not edit repository files. Suggested commands belong only in the report. Treat successful `task` and `project` stdout as JSON and failure stderr as JSON. Exit `2` means this skill built an invalid command and stderr may be plain usage text; stop and report it exactly. Never retry a deleted-project error or restore/reinitialize a project. ## Establish the project and task snapshot 1. Require `git` and `kotgent`, resolve `git rev-parse --show-toplevel`, and read the root `.kotgent.json`. Stop if the file is missing or its `id` is not a UUID. 2. Read both `kotgent project list` and, only if needed, `kotgent project list --archived`. Record whether the exact UUID is live or archived. An unknown UUID is an error. An archived project may still be read, but label it and do not propose an automatic restore. 3. Run `kotgent task list --project <project-uuid>`. Select only rows whose state is exactly `todo` or `in_progress`. 4. Run `kotgent task show <ref>` for every selected row. Use the full detail, including body, dependencies, linked sessions, and activity; do not reconcile from list titles alone. 5. Record HEAD, branch or detached state, and `git status --short` so the report identifies its snapshot. ## Inspect repository evidence in this order 1. Read applicable `AGENTS.md` and `CLAUDE.md` files first. Treat them as constraints, not backlog items. 2. Find active plan and backlog files. Exclude completed, superseded, archived, or historical plans unless they explain a mismatch. 3. Inspect the implementation and tests named by tasks or plans. Use exact symbols, paths, assertions, and observable behavior as evidence. 4. Search tracked content for relevant `TODO` and `FIXME` markers. Do not promote every marker into a task; require a concrete match to intended repository work. 5. Inspect relevant Git history with focused `git log`, `git show`, or `git blame`. Use commit IDs when history proves completion, replacement, or architectural change. 6. Include relevant uncommitted and untracked work from `git status`; never treat a clean HEAD as the whole repository when the worktree contains evidence. Match by scope, acceptance behavior, identifiers, and changed paths. Title similarity alone is not proof. ## Classify the mapping Assign every tracker task and every concrete repository-only work item exactly one primary label: - `aligned`: task scope and current repository intent agree. - `drifted`: both exist, but scope, assumptions, dependencies, or acceptance evidence disagree. - `missing in repo`: a kotgent task has no current repository evidence. - `missing in kotgent`: current repository intent has no matching active kotgent task. - `duplicate`: two or more active kotgent tasks represent the same work; name the canonical ref. For each row, cite evidence as `path:line`, symbol/test name, task activity entry, worktree path, or commit ID. State uncertainty instead of upgrading a weak textual similarity into a fact. ## Report without applying Report the project UUID/status and Git snapshot, then the mapping grouped by label. Include task ref, state, concise scope, repository counterpart, evidence, and consequence. List repository-only items too. For every proposed tracker change, print the exact supported `kotgent` command with concrete refs, project UUID, body, and dependency direction. There is no CLI command to rewrite an existing title or body; for `drifted`, propose a replacement add and a separately confirmed delete instead of inventing an update command. Mutations require either a proven current kotgent pane or a supplied session ID. Never probe IDs found in task `sessions`, read `KOTGENT_SESSION_ID` as identity, or infer the current session from names, cwd, other environment values, or recency. If needed, use at most one ref-less `kotgent task show` to prove current-pane resolution: accept only success or the exact free-session error; this permits the implicit current-pane command form but does not reveal an ID. If neither form is available, say `session ID required` rather than guessing or printing a misleading runnable command. Do not execute any proposed command.
Files in this package (2)
- SKILL.md 5 KB
- agents/openai.yaml 1 KB
Versions
The database has no other skills named sync-tasks.
Database snapshot: 13.11.2026 · package version 07ddcf4aec74 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100create-tasks
Create focused kotgent backlog tasks from a user request, specification, issue list, or implementation plan, with repository and session provenance. Use when the user asks to create, add, file, split, or seed tasks in kotgent; do not use for comparing or reviewing an existing backlog. - 90review-tasks
Audit todo kotgent tasks against the current repository and recommend whether to keep, rewrite, merge, drop, or escalate them. Use when the user asks to review, groom, clean up, triage, or validate the todo backlog for completed, obsolete, conflicting, duplicate, absorbed, or… - 100file-todos
This skill should be used when managing the file-based todo tracking system in the todos/ directory. It provides workflows for creating todos, managing status and dependencies, conducting triage, and integrating with slash commands and code review processes. - 90sync-project
Reconcile a workspace project's config with its backend (Linear/hub) project. Use when the user invokes /dev-loop:sync-project, or asks to "sync the project", "reconcile with Linear", "the project was renamed/archived in Linear", or "check config vs backend drift". Read-only by… - 96sync-roadmap
Reconcile ROADMAP.md checkbox state against on-disk SUMMARY.md presence. Default: silently corrects drift; --dry-run previews; --interactive prompts per change. Triggers on: "sync roadmap", "reconcile roadmap", "fix roadmap drift", "is the roadmap accurate". - 86release-notes
Compare the repository with the team's Folio wiki and write release notes: read git log since the last tag, read the Roadmap table, create or update a Release notes page and add what the roadmap table is missing. Use when asked for release notes or to sync the wiki with the code.