Skip to content

[Docs] Update /docs/admin-guide for Sprint 3a + ClickUp transition status #97

Description

@ProfessorPolymorphic

Context

Sprint 4 audit (post-PR #93) found that app/docs/admin-guide/page.tsx (144 LOC) predates Sprint 3a delivery improvements and doesn't acknowledge the in-progress ClickUp transition.

Gaps to close

Sprint 3a additions missing:

  • The named-human intake flow (Colin Armitage as the named owner; SLA captured in lib/intake-config.ts).
  • The /intake/[token] submitter status URL — bookmarkable, no login required.
  • The similarity preview that runs during the assessment (POST /api/similarity/preview), not just on the post-submit admin view.

ClickUp transition framing:

  • The current admin-guide describes a steady-state Postgres-backed workflow without flagging that /admin/submissions is transitional. Per CLAUDE.md and REFACTOR.md, Sprint 3b (ClickUp wiring) will retire /admin/submissions once landed; the doc should at minimum mention this so admins don't invest in workflows that will move.

Acceptance criteria

  • Submission lifecycle described accurately, including the new /intake/[token] status surface
  • Named-human + SLA flow documented
  • Similarity preview (during-assessment) called out separately from the post-submit similarity panel
  • Brief callout on the in-progress ClickUp transition and what's expected to change
  • Submission status values verified against current Postgres schema

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpriority-lowLower prioritytechnicalTechnical improvements for agentic development

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions