Skip to content

cortex: tasks, not phases — slug identity, ten-word Summary, board re-rendered - #21

Merged
Jammy2211 merged 3 commits into
mainfrom
feature/cortex-tasks-not-phases
Sep 7, 2026
Merged

Jammy2211 merged 3 commits into
mainfrom
feature/cortex-tasks-not-phases

Conversation

@Jammy2211

@Jammy2211 Jammy2211 commented Sep 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Pairs with PyAutoLabs/PyAutoBrain#361.

Science is unordered ideas, not a numbered sequence. The Cortex now speaks tasks: phases/ → tasks/, the Phase: N header is deleted (and rejected by check as a retired key), the slug is the identity, and every task carries a required ten-word Summary: — the question it answers — which is the line the board shows. Rulings point at Task:. The board is re-rendered on the new vocabulary, with every open task listed under its project one coloured line each (the rendering change is PyAutoBrain's PR, referenced below).

Folds in the wording of #17 ("a submission is made on the human's ask"), which is closed as superseded.

Closes #20. Pairs with the PyAutoBrain PR on the same branch (feature/cortex-tasks-not-phases).

API Changes

  • scripts/cortex.py: the Phase class, PHASE_STATES, load_phases, phase_problems, move_phase, rule_phase, new_phase are now Task, TASK_STATES, load_tasks, task_problems, move_task, rule_task, new_task; task paths match tasks/<project>/<slug>.md.
  • check requires Summary: (non-empty, ≤10 words) on every task and rejects a Phase: header on tasks and rulings.
  • new <project> <slug> loses --phase and gains the required --summary.
  • Ruling head field Phase: → Task:; generated ruling title is # <R-id> — <verb> <project> <slug>.
  • scripts/ledger_merge.py and the four workflows filter on tasks/**.
    See full details below.

Test Plan

  • python3 scripts/cortex.py check → OK
  • python3 -m pytest tests -q → 125 passed (new: summary required / capped at ten words / Phase: dead / new --summary / ruling Task: resolution)
  • pyauto-brain cortex dashboard --apply twice, --check reports current
  • Reviewer: read dashboard.md ## Projects — every open task one line, summaries legible
Full API Changes (for automation & release notes)

Removed

  • Phase: task header and the task number — the slug is the identity; DEAD_KEYS names it retired.
  • new --phase <n>; the duplicate-number refusal.
  • phases/ directory (moved, see Migration).

Added

  • Summary: task header, required, SUMMARY_MAX_WORDS = 10, checked.
  • new --summary "<≤10 words>" (required).
  • Ruling head field Task: tasks/<project>/<slug>.md.
  • docs/schema_decisions.md decision 59 (2026-09-07: tasks not phases).

Migration

  • Before: phases/inference_programme/prodigy_mass_pix.md with Phase: 22; ruling Phase: phases/…; cortex.py new inference_programme foo --phase 24
  • After: tasks/inference_programme/prodigy_mass_pix.md with Summary: Does a gradient search beat Nautilus on mass_pix; ruling Task: tasks/…; cortex.py new inference_programme foo --summary "…"
  • Kept as history: closed batches/*.md member lines and ruling bodies still say phases/…; inference_programme slugs phase2_…–phase5_… name the programme's own phases, not Cortex numbers.

Generated by the PyAutoLabs agent workflow.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EpM4gQikgEtCqpBJ3hzgct

Jammy2211 and others added 3 commits September 7, 2026 14:12
Science is unordered ideas, not a numbered sequence: phases/ → tasks/,
the Phase: number is deleted, Summary: (≤10 words, the question the task
answers) is required and checked, rulings point at Task:. Folds in the
wording of #17. Refs #20.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EpM4gQikgEtCqpBJ3hzgct
Refs #20.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EpM4gQikgEtCqpBJ3hzgct
Refs #20.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EpM4gQikgEtCqpBJ3hzgct
@Jammy2211 Jammy2211 added the pending-release PR queued for the next release build label Sep 7, 2026
@Jammy2211
Jammy2211 merged commit 6d4c3c7 into main Sep 7, 2026
1 of 2 checks passed
@Jammy2211
Jammy2211 deleted the feature/cortex-tasks-not-phases branch September 7, 2026 19:43
@Jammy2211 Jammy2211 removed the pending-release PR queued for the next release build label Oct 7, 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.

feat: Cortex tasks not phases — summaries, colours, fewer sections

1 participant