Skip to content

Add pf-guide and rework the workflow skills - #2

Draft
Tezenari wants to merge 5 commits into
mainfrom
feat/using-project-feed-skill
Draft

Tezenari wants to merge 5 commits into
mainfrom
feat/using-project-feed-skill

Conversation

@Tezenari

@Tezenari Tezenari commented Oct 15, 2026 •

Copy link
Copy Markdown
Member

Adds pf-guide, a guide to every part of Project Feed for agents on MCP or the pf CLI. Its SKILL.md routes to one reference per area: connection and conventions, posts and versions, media uploads, media review and annotations, tasks, docs, canvases, chat, handoffs, and the CLI.

Also rewrites task-workflow, plan-project, project-status, and work-triage, and folds in media-review-loop from #1 with corrections. The old version told agents to subscribe to MCP events, which are off on the hosted server.

Every claim was checked against the live staging tools/list and by calling the tools in a sandbox project. That turned up behavior the docs don't cover:

  • get_task accepts PRO-42 and 42, but most write tools and get_post need the internal ID.
  • Posts and tasks share one identifier sequence per project.
  • get_post returns no files. list_media does.
  • After a version drops a file, its annotations stay open but get_annotation_frame returns no image.
  • create_post takes no idempotency key, and unknown arguments are rejected.

Behavior evals ran old and new skills on the same 9 tasks against staging fixtures, with Sonnet subagents. The graders check the resulting server state and call logs. The new skills pass 45 of 45 checks and the old ones 41 of 45. The old skills missed verification steps in plans, skipped a post with open feedback in a status report, failed lookups by identifier, and resolved a note on a dropped file without viewing it. The new skills use about 15% more tokens per run.

All client manifests move to 0.4.0. Supersedes #1.

@Tezenari Tezenari changed the title Add using-project-feed skill Add using-project-feed and rework the workflow skills Oct 15, 2026
@Tezenari Tezenari changed the title Add using-project-feed and rework the workflow skills Add pf-guide and rework the workflow skills Oct 15, 2026
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