Skip to content

docs: vision-alignment check for task creation#52

Merged
fazxes merged 2 commits intomainfrom
docs/vision-alignment-check
Apr 5, 2026
Merged

docs: vision-alignment check for task creation#52
fazxes merged 2 commits intomainfrom
docs/vision-alignment-check

Conversation

@fazxes
Copy link
Copy Markdown
Member

@fazxes fazxes commented Apr 5, 2026

Summary

  • Add vision_section frontmatter field to task files (loop1, loop2, self-maintaining, meta-prompt, none)
  • Add vision-alignment rule to docs/tasks/GUIDE.md: before creating tasks, check last 5 — if 3+ target the same section, new tasks must prioritize a different section
  • Update evolve.md Step 6n constraints and output template to enforce alignment checking
  • Moves Meta-Prompt "Priority engine" from 50% to 60% in tracker
  • Includes prior session housekeeping (handoff compaction, task archival)

Task #31

Test plan

  • make check passes (663 tests, all green)
  • Next daemon session uses vision_section field when generating tasks
  • Alignment check triggers when last 5 tasks cluster on one section

fazxes added 2 commits April 5, 2026 01:40
Add vision_section frontmatter field and alignment rule to task
creation process. Before creating tasks, agents must check the last
5 tasks -- if 3+ target the same vision section, new tasks must
prioritize a different section. Updated GUIDE.md, evolve.md Step 6n,
and report templates. Moves Meta-Prompt priority engine 50% -> 60%.

Also includes prior session housekeeping: handoff compaction
(0022-0030 -> weekly), task archival (done tasks -> archive/).

Task #31
Reviewer noted the GUIDE.md rule allows overriding alignment for
urgent work, but the evolve.md Step 6n constraint was absolute.
Add the same exception clause for consistency.
@fazxes fazxes merged commit e7768e1 into main Apr 5, 2026
@fazxes fazxes deleted the docs/vision-alignment-check branch April 5, 2026 05:43
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f2a6315d20

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/tasks/GUIDE.md

The task queue can drift — all tasks end up targeting the same vision section while other sections stagnate. Before creating new tasks, check alignment:

1. Read the last 5 tasks created (by number, regardless of status)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include archived tasks in last-five alignment scan

The new rule says to check the “last 5 tasks created (by number, regardless of status),” but completed tasks are moved out of docs/tasks/ into docs/tasks/archive/ between sessions, so this instruction is underspecified and will often count the wrong files if someone scans only the active directory. In practice, that can mis-detect clustering and cause the alignment guard to be skipped or triggered incorrectly; the rule should explicitly say to compute the last five across both active and archived task files (or via .next-id lookback).

Useful? React with 👍 / 👎.

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