agent-taskstate-maintainer

Maintain and verify the ..\agent-taskstate repository. Use when working in this repo to review requirements, fix implementation gaps, align code with docs, tests, and schema, update README guidance, or prepare acceptance, commit, and push. Triggers include requests about typed_ref, context bundles, resolver, tracker bridge, kv-priority-roadmap, and repo-specific code review.

Jump to install

Repository: RNA4219/agent-taskstate
Last source activity: July 6, 2026 at 14:59
Detected SKILL.md language: English
Stars: 0
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/RNA4219/agent-taskstate --skill agent-taskstate-maintainer

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Agent-taskstate Maintainer

Overview

Use this skill only inside agent-taskstate. Treat docs/kv-priority-roadmap/ as requirement supplements that must stay consistent with the implementation.

Workflow

Read the relevant context in this order when needed:

README.md
BLUEPRINT.md
GUARDRAILS.md
matching file under docs/src/
matching file under docs/kv-priority-roadmap/

Map the request to the main modules before editing:

typed_ref: src/typed_ref.py, tests/test_typed_ref.py, docs/contracts/typed-ref.md
context bundle: src/context_bundle.py, tests/test_context_bundle.py, docs/schema/agent-taskstate.sql
resolver: src/resolver.py, tests/test_context_rebuild_resolver.py
tracker bridge: src/tracker_bridge.py, tests/test_tracker_bridge.py
state transition: src/state_transition.py, tests/test_state_transition.py

Update implementation, tests, and schema/docs together when the behavior changes.

Validate with pytest -q before finishing. Use narrower suites only while iterating.

Inspect git status --short before commit and exclude __pycache__, workflow-cookbook/, and unrelated local artifacts.

Repo Invariants

Keep typed_ref in 4-segment canonical form: <domain>:<entity_type>:<provider>:<entity_id>.

Keep agent-taskstate as the source of truth for internal task state. Treat tracker data as auxiliary input.

Preserve context bundle auditability: diagnostics, source refs, raw-inclusion flags, and generator metadata must remain traceable.

When asked for review, report bugs, requirement gaps, and regression risks before summaries.

When editing docs, keep README.md agent-oriented and README-human.md human-oriented.

Acceptance Pass

Re-check the relevant roadmap item under docs/kv-priority-roadmap/.

Confirm the touched tests cover the changed behavior.

If schema or migration contracts moved, update both docs/schema/agent-taskstate.sql and docs/migrations/001_init.sql.

Commit in Japanese and push only after verification succeeds.