Work item tracking and task management using the Jerry Framework hierarchy (Initiative, Epic, Feature, Story, Task, Enabler, Bug, Impediment). Manages WORKTRACKER.md manifests, tracks progress, and enforces template usage for consistent work decomposition.
Version: 1.1.0 Framework: Jerry Worktracking Framework v1.0 Constitutional Compliance: Jerry Constitution v1.0 (P-002, P-003, P-020)
| Section | Purpose |
|---|---|
| Overview | What this skill does and core capabilities |
| When to Use This Skill | Activation triggers and use cases |
| Core Rules (Always Loaded) |
Behavior rules loaded via @ import |
| Worktracker Agents | Specialized agents for verification, visualization, auditing |
| Quick Reference | Entity hierarchy, templates, key locations |
| Routing Disambiguation | When this skill is the wrong choice |
| Constitutional Compliance | Principle mapping with consequences |
| Additional Resources | Links to detailed rule files |
The Worktracker skill provides comprehensive work item tracking and task management capabilities within the Jerry Framework. It implements a hierarchical work decomposition structure compatible with ADO Scrum, SAFe, and JIRA methodologies.
Invoke /worktracker when you need to:
The following rules are automatically loaded when this skill is invoked:
@rules/worktracker-behavior-rules.md @rules/worktracker-templates.md @rules/worktracker-content-standards.md
The worktracker skill includes specialized agents for advanced operations. These agents follow the worker pattern and are invoked by MAIN CONTEXT (Claude) via the Task tool, maintaining P-003 compliance.
| Agent | Model | Purpose | Invocation Example |
|---|---|---|---|
wt-verifier | sonnet | Validate acceptance criteria before closure | "Verify EN-001 is ready for closure" |
wt-visualizer | haiku | Generate Mermaid diagrams for hierarchies | "Create a hierarchy diagram for FEAT-002" |
wt-auditor | sonnet | Audit cross-file integrity and templates | "Audit the worktracker for PROJ-009" |
| User Intent | Keywords | Agent |
|---|---|---|
| Verify completion readiness | "verify", "check ready", "validate AC" | wt-verifier |
| Generate visual diagrams | "diagram", "visualize", "show hierarchy" | wt-visualizer |
| Check integrity/compliance | "audit", "check integrity", "find orphans" | wt-auditor |
| Full status report | "status of", "progress on" | wt-verifier + wt-visualizer |
| Agent | Location |
|---|---|
| wt-verifier | skills/worktracker/agents/wt-verifier.md |
| wt-visualizer | skills/worktracker/agents/wt-visualizer.md |
| wt-auditor | skills/worktracker/agents/wt-auditor.md |
Agents are workers, NOT orchestrators:
Task tool from MAIN CONTEXTUser Request --> MAIN CONTEXT --> Task(wt-verifier) --> Report --> User
|
+-- Agents never invoke other agents (P-003)
Agents enforce Worktracker Integrity (WTI) rules defined in .context/templates/worktracker/WTI_RULES.md:
| Rule | Description | Enforcing Agent |
|---|---|---|
| WTI-001 | Real-Time State | wt-auditor |
| WTI-002 | No Closure Without Verification | wt-verifier |
| WTI-003 | Truthful State | wt-verifier, wt-auditor |
| WTI-004 | Synchronize Before Reporting | wt-auditor |
| WTI-005 | Atomic State Updates | wt-auditor |
| WTI-006 | Evidence-Based Closure | wt-verifier |
| WTI-008 | Content Quality Standards | wt-auditor |
| WTI-009 | Collaboration Before Creation | (interactive -- MAIN CONTEXT) |
Agent outputs use standardized templates:
| Template | Purpose | Location |
|---|---|---|
| VERIFICATION_REPORT.md | wt-verifier output | .context/templates/worktracker/ |
| AUDIT_REPORT.md | wt-auditor output | .context/templates/worktracker/ |
| Scenario | Recommendation |
|---|---|
| Simple work item creation | Use rules only |
| Pre-closure verification | Use wt-verifier |
| Understanding work structure | Use wt-visualizer |
| Finding integrity issues | Use wt-auditor |
| Full project health check | Use all three agents |
| Parent | Allowed Children |
|---|---|
| Initiative | Epic |
| Epic | Capability, Feature |
| Feature | Story, Enabler |
| Story | Task, Subtask |
| Enabler | Task |
| Task | Subtask |
| Bug | Task |
| Template | Path |
|---|---|
| All worktracker templates | .context/templates/worktracker/ |
| Epic | .context/templates/worktracker/EPIC.md |
| Feature | .context/templates/worktracker/FEATURE.md |
| Enabler | .context/templates/worktracker/ENABLER.md |
| Story | .context/templates/worktracker/STORY.md |
| Task | .context/templates/worktracker/TASK.md |
| Bug | .context/templates/worktracker/BUG.md |
| Discovery | .context/templates/worktracker/DISCOVERY.md |
| Decision | .context/templates/worktracker/DECISION.md |
| File | Purpose |
|---|---|
projects/{ProjectId}/WORKTRACKER.md | Global manifest for project |
projects/{ProjectId}/work/ | Work decomposition folder |
.context/templates/worktracker/ | All worktracker templates |
When this skill is the wrong choice and what happens if misrouted.
| Condition | Use Instead | Consequence of Misrouting |
|---|---|---|
Query answerable by jerry items list or jerry projects list CLI | Jerry CLI directly | Worktracker agents invoked for simple queries waste agent invocation overhead; CLI provides instant results without context consumption |
| Non-entity file operations (general markdown, code files) | Read/Write/Edit tools directly | AST parsing applied to non-entity files produces validation errors; entity schema enforcement fails on non-worktracker content |
| Research, analysis, or root cause investigation | /problem-solving | Worktracker agents have no research methodology; wt-verifier and wt-auditor are scoped to entity integrity, not analytical tasks |
| Requirements engineering or V&V activities | /nasa-se | Worktracker tracks work items, not requirements; no traceability matrix or verification capability |
| Multi-agent workflow coordination | /orchestration | Worktracker manages individual work items, not multi-pipeline workflow state; no checkpointing or sync barriers |
| Adversarial quality review | /adversary | Worktracker has no quality scoring or adversarial strategy capability |
All agents adhere to the Jerry Constitution v1.0:
| Principle | Requirement | Consequence of Violation |
|---|---|---|
| P-003 | NEVER spawn recursive subagents -- max 1 level | Agent hierarchy violation; uncontrolled token consumption |
| P-020 | NEVER override user intent -- ask before destructive ops | Unauthorized action; trust erosion |
| P-022 | NEVER deceive about actions, capabilities, or confidence | Governance undermined; quality assessment invalidated |
| P-002 | NEVER leave outputs in transient context only -- persist to files | Context rot vulnerability; artifacts lost on session compaction |
For detailed reference, the following rule files are available:
Rule Loading Tiers: Auto-loaded rules (behavior-rules, templates) are loaded via
@import because they contain enforcement rules needed for every worktracker operation. Reference rules (entity-hierarchy, system-mappings, directory-structure, todo-integration) are loaded on-demand to conserve context budget.