# Task Manager

> Turn daily product evidence into readable Markdown tasks and generated workstream views.

- Skill: `officebeats/task-manager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add officebeats/task-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/officebeats/task-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: officebeats (https://skillmd.com/u/officebeats)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/officebeats/task-manager

---


# Product Management Task Manager

The task note is the source of truth. `TASK_MASTER.md`, workstream summaries, dashboards, Obsidian, and optional packs are views over the Markdown notes in `5. Trackers/tasks/`.

## Quick Path

1. Task notes are the source of truth: one readable Markdown file per task in `5. Trackers/tasks/`, stable ID in `task_id` frontmatter, human-readable `title` and matching H1.
2. For one pasted evidence item, run `python3 system/scripts/task_intake_fast.py --text "<raw evidence>" --source "<source label>"`.
3. Match evidence against existing tasks and workstreams before creating new state; record source provenance and mark `inferred_fields`.
4. Apply the priority gate: `Today`/`Next` work needs an owner, date or decision gate, intended outcome, and known dependency; consequential ambiguity becomes `status: needs-triage` plus one concrete question.
5. Rebuild generated views with `python3 system/scripts/task_store.py rebuild`; never edit the `TASK_MASTER.md` managed table as primary state.
6. Lead recurring output with readable workstream sections: latest outcome, completed, open items, recommended next 3.

Go deeper for the task note format, daily evidence triangulation rules, upgrade safety, and the optional Obsidian view.

## Core contract

- Create one descriptive Markdown file per task, such as `confirm-beta-customer-list.md`.
- Put the stable internal ID in `task_id` frontmatter, never in the filename or visible H1 for new tasks.
- Require a readable `title` in frontmatter and the same human-readable H1.
- Preserve evidence links, decisions, progress, completed checklist items, dates, and source provenance.
- Treat `5. Trackers/TASK_MASTER.md` as generated navigation. Do not edit its managed task table as primary state.
- Rebuild it with `python3 system/scripts/task_store.py rebuild` after task-note changes.
- Route generated Markdown through `system/scripts/markdown_humanizer.py`; the local formatter adds no model call or full-workspace scan during normal task writes.
- Do not read or synchronize optional packs during normal task management. Packs run only through an explicit `/pack` request.

## Fast capture

For one pasted email, chat, transcript excerpt, or screenshot transcription, run:

```bash
python3 system/scripts/task_intake_fast.py --text "<raw evidence>" --source "<source label>"
```

The fast path must:

1. Save the raw evidence before interpretation.
2. Match and update an existing task note when evidence is strong.
3. Otherwise create a readable candidate note with `status: needs-triage`.
4. Mark inferred owner, date, or workstream fields clearly instead of dropping the task.
5. Rebuild Task Master from the resulting task notes.
6. Defer broad health analysis unless the user asks for it.

## Daily evidence triangulation

Granola, Quill, Outlook, Teams, Slack, local transcripts, and existing Markdown notes are the core evidence loop.

- Use only named or configured read-only source windows; never broad-scan an account or workspace.
- Archive source material locally before routing durable task changes.
- Match evidence against existing tasks and workstreams before creating new ones.
- Consolidate repeated signals from multiple sources under one workstream.
- Record both the initial source and latest confirming source.
- Treat explicit completion evidence as completion; treat implied completion as a confirmation question.
- When historical context is missing or contradictory, run one bounded `/find` query. Its optional semantic recall is only a lead; link the dated Markdown evidence that confirms the task change.
- `/day`, `/week`, and `/boss` use `critical_commitment_refresh.py` to refresh configured sources before ranking work.
- TWG is optional enrichment for an explicitly requested live refresh, never no-context snapshot input. If enabled and healthy, use it only under `.agent/rules/TWG_READ_ONLY.md`; exact Jira/Confluence evidence stays Rovo/native-first.
- If a source fails, label the gap and use cached local evidence for that source while retaining fresh results from successful sources.

## Task note format

```yaml
---
title: Confirm beta customer list
task_id: BPM-0123
status: next
lane: Next
owner: Product
due: 2026-07-24
workstream: Search beta
source_refs:
  - 3. Meetings/transcripts/2026-07-18-product-council.md
inferred_fields:
  - owner
created: 2026-07-18
updated: 2026-07-18
---
```

The body uses these readable sections:

- `# <Task title>`
- `## Summary`
- `## Context`
- `## Success and scope`
- `## Next actions`
- `## Evidence`
- `## Progress`
- `## Decisions`

Keep open actions to three when possible. Retain completed actions with completion date and evidence.

## Priority and quality gate

- Check for a duplicate task or workstream before creating new state.
- Use local `1. Company/ways-of-working.md` when it exists; do not bake one user's reporting structure or scope rules into the public kit.
- Infer missing fields when the evidence reasonably supports them and list those fields in `inferred_fields`.
- For consequential ambiguity, record the task as `needs-triage` and ask one concrete question.
- `Today` and `Next` work should have an owner, date or decision gate, intended outcome, and known dependency.
- Never silently mark a task complete, change source-system state, or discard raw evidence.

## Workstream output

Lead recurring task output with readable workstreams:

```markdown
### Search beta readiness
- Latest outcome: Beta cohort criteria agreed
  - Evidence: Product council on July 18; confirmed in Teams on July 19
- Completed: Instrumentation owner confirmed
  - Completed: July 19 from Teams
- Open items: 2
  - Product — confirm customer list by July 24
- Recommended next 3:
  - Confirm customer list
  - Resolve analytics dependency
  - Prepare go/no-go decision
```

IDs belong in metadata, links, and agent references—not headings or status prose.

## Upgrade safety

Before converting an existing kit, run `python3 system/scripts/upgrade_compat.py --json`. The migration adds safe titles in place, keeps legacy filenames stable, backs up every changed file, and refuses ambiguous or broken task state.

## Optional Obsidian view

After a full `/track` update, run `python3 system/scripts/obsidian_bridge.py guide --json`. Offer the exact kit and task paths when `should_prompt` is true, but never block Markdown task work on Obsidian.