Skip to content

feat: Allow extensible TaskFlow task documents - #144

Merged
hkwuks merged 9 commits into
mainfrom
feature/flexible-task-documents
Nov 17, 2026
Merged

hkwuks merged 9 commits into
mainfrom
feature/flexible-task-documents

Conversation

@hkwuks

@hkwuks hkwuks commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

Summary

Allow TaskFlow task documents to retain relevant additional material from tools and skills, with detail proportionate to task complexity. Treat fenced Markdown examples as examples when checking approval and completion, updating steps and status, changing versions, and archiving. Reject ambiguous reserved records and preserve Todo notes in the correct section.

TaskFlow traceability

  • Task: TaskFlowDocs/achieved/2026-11-16-flexible-task-documents/ (v1, accepted and archived)
  • Scope: TaskFlow skill guidance; task document parsing and lifecycle hooks; regression tests and task records.
  • Base branch: main
  • Target repository: hkwuks/TaskFlow

Verification

  • The Hooks workflow passed for code commit 90c9fee: https://github.com/hkwuks/TaskFlow/actions/runs/43999790222 (Ubuntu, macOS, Windows and evals).
  • git diff --check origin/main...HEAD.
  • Skill validation: quick_validate.py skills/taskflow with PYTHONUTF8=1.
  • Results recorded in the archived TaskFlow Plan.

Subsequent commits update only task verification and archive documents. The first CI run exposed an ambiguous legacy test fixture and a Bash 3.2 heredoc parsing problem; the fixture explicitly checks the original rejection reason and the portable implementation passed the matrix above. Local full Bash smoke remains unavailable because Git Bash could not create the required native symlinks.

Review boundaries

  • No secrets or opaque remote payloads included.
  • No unrelated task or user files changed.
  • Remote/base assumptions are stated.
  • Known limitations and follow-ups are documented.

The user accepted the task, and its documents and Todo are archived in this PR. Real-host end-to-end behavior with external skill output remains unverified.

@hkwuks hkwuks changed the title Allow extensible TaskFlow task documents feat: Allow extensible TaskFlow task documents Nov 17, 2026
@hkwuks
hkwuks marked this pull request as ready for review November 17, 2026 02:30
@hkwuks
hkwuks merged commit 5044185 into main Nov 17, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant