forgejo_admin/pal-e-api
1
0
Fork 1
Code Issues 9 Pull requests 1 Projects Releases Packages Wiki Activity Actions

Remove plan items from all boards + update project page template #203

New issue
Closed
opened 2026-03-24 17:32:18 +00:00 by forgejo_admin · 5 comments
forgejo_admin commented 2026-03-24 17:32:18 +00:00
Owner
Copy link

Type

Feature

Lineage

Standalone — board-pal-e-agency kanban philosophy alignment

Repo

forgejo_admin/pal-e-docs (API for board operations), ~/claude-custom (template updates)

User Story

As the superuser
I want plan items removed from all boards and the project page template updated
So that boards show only executable work and the template reflects kanban-over-plans philosophy

Context

Plans were scaffolding for a platform without kanban. Now the board IS the decomposition tool. Plan items sit permanently in in_progress on every board, inflating WIP counts and adding noise. The project page template still has a "Plan" section that should merge into "Board." See convention-kanban-over-plans for the full rationale.

What Broke

Not a bug — a philosophy evolution. Plan items inflate WIP, the Plan section duplicates the Board section, and the template doesn't reflect how we actually work.

File Targets

Board operations (via MCP):

  • Remove plan-type items from all 13 boards
  • Count: ~7 plan items across boards (pal-e-platform, pal-e-docs, westside, agency, minio-mobile, backup, posts)

Template update:

  • template-project-page note in pal-e-docs — update section order (remove Plan, promote Architecture to #3)
  • template-ticket note — add arch: label as recommended

Acceptance Criteria

  • Zero plan-type items on any board
  • template-project-page reflects new section order: Vision, User Stories, Architecture, Board, Status, Milestones, Repos
  • template-ticket mentions arch: label convention
  • Existing plan notes untouched (historical reference)

Test Expectations

  • list_board_items(board_slug="board-pal-e-platform", item_type="plan") returns empty
  • Same for all 13 boards

Constraints

  • Don't delete plan notes — they're historical
  • Don't delete phase items — they're executable work
  • Only remove items where item_type="plan"

Checklist

  • PR opened
  • Tests pass
  • No unrelated changes

Related

  • convention-kanban-over-plans — the philosophy decision
  • project-pal-e-agency — process ownership
### Type Feature ### Lineage Standalone — board-pal-e-agency kanban philosophy alignment ### Repo `forgejo_admin/pal-e-docs` (API for board operations), `~/claude-custom` (template updates) ### User Story As the superuser I want plan items removed from all boards and the project page template updated So that boards show only executable work and the template reflects kanban-over-plans philosophy ### Context Plans were scaffolding for a platform without kanban. Now the board IS the decomposition tool. Plan items sit permanently in in_progress on every board, inflating WIP counts and adding noise. The project page template still has a "Plan" section that should merge into "Board." See `convention-kanban-over-plans` for the full rationale. ### What Broke Not a bug — a philosophy evolution. Plan items inflate WIP, the Plan section duplicates the Board section, and the template doesn't reflect how we actually work. ### File Targets Board operations (via MCP): - Remove plan-type items from all 13 boards - Count: ~7 plan items across boards (pal-e-platform, pal-e-docs, westside, agency, minio-mobile, backup, posts) Template update: - `template-project-page` note in pal-e-docs — update section order (remove Plan, promote Architecture to #3) - `template-ticket` note — add `arch:` label as recommended ### Acceptance Criteria - [ ] Zero plan-type items on any board - [ ] template-project-page reflects new section order: Vision, User Stories, Architecture, Board, Status, Milestones, Repos - [ ] template-ticket mentions arch: label convention - [ ] Existing plan notes untouched (historical reference) ### Test Expectations - [ ] `list_board_items(board_slug="board-pal-e-platform", item_type="plan")` returns empty - [ ] Same for all 13 boards ### Constraints - Don't delete plan notes — they're historical - Don't delete phase items — they're executable work - Only remove items where item_type="plan" ### Checklist - [ ] PR opened - [ ] Tests pass - [ ] No unrelated changes ### Related - `convention-kanban-over-plans` — the philosophy decision - `project-pal-e-agency` — process ownership
forgejo_admin commented 2026-03-24 17:55:31 +00:00
Author
Owner
Copy link

Scope Review: NEEDS_REFINEMENT

Review note: review-323-2026-03-24

Critical dependency found: sync_board endpoint (POST /boards/{slug}/sync) uses plan-type board items to discover child phases. Removing plan items will silently break phase sync across all boards, including every /update-docs invocation.

  • sync_board regression: boards.py:251 queries BoardItem.item_type == BoardItemType.plan to find phases. Zero plan items = zero phases synced. Silent failure (returns 0/0/0).
  • Repo field inaccuracy: ~/claude-custom listed but no files there need changes. Templates are pal-e-docs notes.
  • AC pre-satisfied: arch: label already documented in template-ticket Label Conventions table.
  • Count off: 8 plan items across 7 boards, not ~7.

Ticket needs: (1) sync_board rearchitecture or deprecation plan, (2) remove claude-custom from Repo field.

## Scope Review: NEEDS_REFINEMENT Review note: `review-323-2026-03-24` Critical dependency found: `sync_board` endpoint (`POST /boards/{slug}/sync`) uses plan-type board items to discover child phases. Removing plan items will silently break phase sync across all boards, including every `/update-docs` invocation. - **sync_board regression**: `boards.py:251` queries `BoardItem.item_type == BoardItemType.plan` to find phases. Zero plan items = zero phases synced. Silent failure (returns 0/0/0). - **Repo field inaccuracy**: `~/claude-custom` listed but no files there need changes. Templates are pal-e-docs notes. - **AC pre-satisfied**: `arch:` label already documented in `template-ticket` Label Conventions table. - **Count off**: 8 plan items across 7 boards, not ~7. Ticket needs: (1) sync_board rearchitecture or deprecation plan, (2) remove claude-custom from Repo field.
forgejo_admin commented 2026-03-24 18:08:25 +00:00
Author
Owner
Copy link

Review Refinements (from review-323-2026-03-24)

CRITICAL: sync_board dependency. POST /boards/{slug}/sync at routes/boards.py:251 discovers phases by querying plan-type board items → finding their child phase notes. Removing plan items would cause sync to silently return 0/0/0. This breaks /update-docs.

Resolution: sync_board must be refactored FIRST to discover plan notes from the project directly (notes where note_type="plan" and project_id=X) instead of from plan board items. The plan notes still exist — they're just not on the board anymore.

New dependency: This ticket depends on a sync_board refactor ticket. Creating it now.

Fix 2: Repo field — drop ~/claude-custom. All template changes are pal-e-docs notes, not filesystem files.

Fix 3: AC "template-ticket mentions arch: label" already satisfied — remove.

Fix 4: Count is 8 plan items across 7 boards (pal-e-docs has 2), not "~7".

## Review Refinements (from review-323-2026-03-24) **CRITICAL: sync_board dependency.** `POST /boards/{slug}/sync` at `routes/boards.py:251` discovers phases by querying plan-type board items → finding their child phase notes. Removing plan items would cause sync to silently return 0/0/0. This breaks /update-docs. **Resolution:** sync_board must be refactored FIRST to discover plan notes from the project directly (`notes where note_type="plan" and project_id=X`) instead of from plan board items. The plan notes still exist — they're just not on the board anymore. **New dependency:** This ticket depends on a sync_board refactor ticket. Creating it now. **Fix 2:** Repo field — drop `~/claude-custom`. All template changes are pal-e-docs notes, not filesystem files. **Fix 3:** AC "template-ticket mentions arch: label" already satisfied — remove. **Fix 4:** Count is 8 plan items across 7 boards (pal-e-docs has 2), not "~7".
forgejo_admin commented 2026-03-24 20:04:41 +00:00
Author
Owner
Copy link

Completed — All MCP operations done

Plan items removed (7 total)

Board Item ID Note Slug
board-pal-e-platform 7 plan-pal-e-platform
board-pal-e-docs 1 plan-pal-e-docs
board-pal-e-docs 149 plan-2026-03-16-knowledge-architecture
board-pal-e-agency 23 plan-pal-e-agency
board-westside-basketball 136 plan-wkq
board-minio-mobile 251 plan-minio-mobile
board-pal-e-backup 148 plan-pal-e-backup

Boards with zero plan items (no action needed): board-mcd-tracker, board-pal-e-pac, board-pal-e-world, board-private, board-journal.
Boards that don't exist (404): board-pal-e-posts, board-pal-e-mail.

template-project-page updated

  • Removed Plan section from template
  • Reordered sections: Vision, User Stories, Architecture, Board, Status, Milestones, Repos
  • Architecture promoted above Board (stable project anchor)
  • Removed Inbox/Backlog section (backlog is a board column, not a page section)
  • Simplified Key Principles (removed plan-centric principles)
  • Added What Changed (2026-03-24) changelog entry
  • Removed template-plan from Related links

Verification

All 6 boards that previously had plan items confirmed empty via list_board_items(item_type="plan").

Constraints honored

  • Plan notes NOT deleted (historical reference preserved)
  • Phase items NOT touched (only item_type="plan" removed)
  • No code files modified (entirely MCP operations)
## Completed — All MCP operations done ### Plan items removed (7 total) | Board | Item ID | Note Slug | |-------|---------|-----------| | board-pal-e-platform | 7 | plan-pal-e-platform | | board-pal-e-docs | 1 | plan-pal-e-docs | | board-pal-e-docs | 149 | plan-2026-03-16-knowledge-architecture | | board-pal-e-agency | 23 | plan-pal-e-agency | | board-westside-basketball | 136 | plan-wkq | | board-minio-mobile | 251 | plan-minio-mobile | | board-pal-e-backup | 148 | plan-pal-e-backup | Boards with zero plan items (no action needed): board-mcd-tracker, board-pal-e-pac, board-pal-e-world, board-private, board-journal. Boards that don't exist (404): board-pal-e-posts, board-pal-e-mail. ### template-project-page updated - Removed Plan section from template - Reordered sections: Vision, User Stories, Architecture, Board, Status, Milestones, Repos - Architecture promoted above Board (stable project anchor) - Removed Inbox/Backlog section (backlog is a board column, not a page section) - Simplified Key Principles (removed plan-centric principles) - Added What Changed (2026-03-24) changelog entry - Removed `template-plan` from Related links ### Verification All 6 boards that previously had plan items confirmed empty via `list_board_items(item_type="plan")`. ### Constraints honored - Plan notes NOT deleted (historical reference preserved) - Phase items NOT touched (only item_type="plan" removed) - No code files modified (entirely MCP operations)
forgejo_admin commented 2026-03-24 20:20:07 +00:00
Author
Owner
Copy link

All acceptance criteria met:

  • Zero plan-type items on any board (7 removed across 6 boards)
  • template-project-page updated with new section order
  • Plan notes preserved as historical reference

Closing.

All acceptance criteria met: - Zero plan-type items on any board (7 removed across 6 boards) - template-project-page updated with new section order - Plan notes preserved as historical reference Closing.
forgejo_admin commented 2026-03-24 20:43:06 +00:00
Author
Owner
Copy link

Verification Complete — All Acceptance Criteria Already Met

Scanned all 13 boards and both template notes. Everything specified in this issue has already been implemented.

Board Scan Results (plan-type items)

Board Result
board-pal-e-platform 0 plan items
board-pal-e-docs 0 plan items
board-pal-e-agency 0 plan items
board-westside-basketball 0 plan items
board-mcd-tracker 0 plan items
board-minio-mobile 0 plan items
board-pal-e-backup 0 plan items
board-pal-e-posts Board does not exist (404)
board-pal-e-mail Board does not exist (404)
board-svelte-playground 0 plan items
board-pal-e-pac 0 plan items
board-private 0 plan items
board-journal 0 plan items

Zero plan-type items across all boards.

template-project-page

Already updated (has "What Changed (2026-03-24)" changelog entry). Section order is:

  1. Vision
  2. User Stories
  3. Architecture (promoted to #3)
  4. Board
  5. Status
  6. Milestones
  7. Repos

Plan section removed. Architecture promoted above Board.

template-ticket

Already has arch: label documented in the Label Conventions table:

  • Format: arch:{component-name}
  • Purpose: "Which architecture component this ticket touches"
  • Examples: arch:board-api, arch:postgres, arch:ci-pipeline
  • References convention-architecture-ids for naming patterns

Conclusion

No changes needed — all three acceptance criteria were satisfied before this issue was picked up. Likely completed during an earlier session on 2026-03-24 (the template-project-page changelog confirms this date).

This issue can be closed as already-done.

## Verification Complete — All Acceptance Criteria Already Met Scanned all 13 boards and both template notes. Everything specified in this issue has already been implemented. ### Board Scan Results (plan-type items) | Board | Result | |-------|--------| | board-pal-e-platform | 0 plan items | | board-pal-e-docs | 0 plan items | | board-pal-e-agency | 0 plan items | | board-westside-basketball | 0 plan items | | board-mcd-tracker | 0 plan items | | board-minio-mobile | 0 plan items | | board-pal-e-backup | 0 plan items | | board-pal-e-posts | Board does not exist (404) | | board-pal-e-mail | Board does not exist (404) | | board-svelte-playground | 0 plan items | | board-pal-e-pac | 0 plan items | | board-private | 0 plan items | | board-journal | 0 plan items | **Zero plan-type items across all boards.** ### template-project-page Already updated (has "What Changed (2026-03-24)" changelog entry). Section order is: 1. Vision 2. User Stories 3. Architecture (promoted to #3) 4. Board 5. Status 6. Milestones 7. Repos Plan section removed. Architecture promoted above Board. ### template-ticket Already has `arch:` label documented in the Label Conventions table: - Format: `arch:{component-name}` - Purpose: "Which architecture component this ticket touches" - Examples: `arch:board-api`, `arch:postgres`, `arch:ci-pipeline` - References `convention-architecture-ids` for naming patterns ### Conclusion No changes needed — all three acceptance criteria were satisfied before this issue was picked up. Likely completed during an earlier session on 2026-03-24 (the template-project-page changelog confirms this date). This issue can be closed as already-done.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
199-drop-legacy-boards
158-incident-fix-migration-crash-drop-hnsw-i
128-add-jinja2-template-rendering-endpoint-p
132-fix-template-endpoint-qa-nits-is-public
123-clean-up-test-seed-block-objects-with-nu
124-harden-anchor-id-column-to-not-null
119-generate-anchor-ids-for-all-block-types
111-7e-1a-qa-nits-cleanup-redundant-assignme
11-fix-repos-formatting
5-browse-frontend
1-scaffold-project
No results found.
Labels
Clear labels   
domain:backend

   
domain:devops

   
domain:frontend

   
status:approved

QA passed, awaiting merge approval

  
status:in-progress

Dev agent is actively working

  
status:needs-fix

QA found issues, back to dev

  
status:qa

PR submitted, awaiting QA review

  
type:bug

Bug fix

  
type:devops

Infrastructure/CI/config work

  
type:feature

New functionality

No labels
domain:backend
domain:devops
domain:frontend
status:approved
status:in-progress
status:needs-fix
status:qa
type:bug
type:devops
type:feature
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
forgejo_admin/pal-e-api#203
No description provided.