Files

Mirror to GitHub / mirror (push) Successful in 3s

Details

fix(ai): correct stale role-hierarchy and file-listing claims

Codex review of the dual-agent handoff migration flagged factual errors
carried over verbatim from the pre-migration CLAUDE.md. All claims
verified against the live code before correction.

PROJECT_CONTEXT.md — SaaS shape:
- Role hierarchy was `super_admin > team_admin > engineer > viewer`,
  but `backend/app/core/permissions.py:4` and
  `frontend/src/hooks/usePermissions.ts:4` both define it as
  `super_admin > owner > engineer > viewer`. The `team_admin` concept
  exists separately as an orthogonal team-scoped gate
  (`require_team_admin`, `is_team_admin=True` + valid `team_id`), not
  a level in the primary hierarchy.
- Dep list was missing `require_account_owner` and `require_team_admin`,
  both present in `backend/app/api/deps.py`.

PROJECT_CONTEXT.md — directory tree:
- `api/endpoints/` comment listed 11 routers; `api/router.py` actually
  registers 50+. Replaced with a summary that points at `router.py` as
  the source of truth instead of trying to maintain a freezing list.
- `services/psa/` comment omitted `exceptions.py` and `ticket_context.py`,
  both present in the directory.

CURRENT_TASK.md + TODO.md:
- Replaced `<!-- EXAMPLE -->` placeholders with clearer empty-state
  sentinels so a resume agent sees "no real task yet" at a glance
  rather than placeholder acceptance criteria that look unresolved.

SESSION_LOG.md updated with a follow-up bullet documenting this pass.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-04-24 15:09:22 -04:00

1.6 KiB

Raw Blame History

SESSION_LOG.md

Append-only chronological record. Newest entries at the top. Skim when broader context is needed. Entry format:
## YYYY-MM-DD HH:MM <timezone> — <agent> — <one-line summary>
- What was accomplished
- What was left for next session
- Files touched

2026-04-24 — Claude Code — Migrate to dual-agent handoff system

Split CLAUDE.md into .ai/PROJECT_CONTEXT.md + shared-protocol root files (CLAUDE.md, AGENTS.md).
Seeded CURRENT_TASK.md, HANDOFF.md, TODO.md, DECISIONS.md, SESSION_LOG.md, README.md.
Deleted legacy SESSION-HANDOFF.md (superseded).
Left for next session: first real feature task should replace the seed CURRENT_TASK.md and update HANDOFF.md with real resume state.
Files touched: .ai/*.md (created), CLAUDE.md (rewritten), AGENTS.md (created), SESSION-HANDOFF.md (deleted).
Follow-up (same day): Codex review pass flagged stale SaaS-role claim and incomplete file-listings carried over from the pre-migration CLAUDE.md. Verified against backend/app/core/permissions.py, frontend/src/hooks/usePermissions.ts, backend/app/api/deps.py, backend/app/api/router.py, and backend/app/services/psa/. Corrected PROJECT_CONTEXT.md role hierarchy (super_admin > owner > engineer > viewer, not team_admin), added require_account_owner / require_team_admin to deps list, replaced stale endpoint comment with a summary pointing at api/router.py, added exceptions.py + ticket_context.py to the PSA file list. Also replaced seed-example content in CURRENT_TASK.md and TODO.md with clearer empty-state sentinels.

1.6 KiB Raw Blame History

SESSION_LOG.md

2026-04-24 — Claude Code — Migrate to dual-agent handoff system

1.6 KiB

Raw Blame History