Skip to content

Cockpit readiness: update UX copy, docs, and validation for path/version model #161

Description

@smota

Background & Problem Statement

Epic: #156

After adding path-aware readiness and version lens, docs and QA must explain phase completion vs evidence, skipped roles, scoring, and version state.

Proposed Solution

Update Cockpit docs, QA checklist, and validation evidence.

Requirements

  • Explain evidence as supporting proof behind phase/role completion.
  • Explain selected path/profile/risk and skipped-role handling.
  • Explain Readiness Health scoring and denominator.
  • Explain Version/Release Lens.
  • Update manual QA checklist with bounded, standard, high-assurance, and awaiting-release scenarios.

Acceptance criteria

  • Docs updated for new concepts.
  • QA checklist covers skipped role no-penalty behavior.
  • QA checklist covers version/release lens.
  • Product copy review completed.

Test plan

agentflow-sdlc@0.7.0 test C:\Code\multi-agent-sdlc
vitest run

�[1m�[7m�[36m RUN �[39m�[27m�[22m �[36mv2.1.9 �[39m�[90mC:/Code/multi-agent-sdlc�[39m

�[32m✓�[39m lib/tests/execution-targets.test.mjs �[2m(�[22m�[2m15 tests�[22m�[2m)�[22m�[90m 19�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/capabilities.test.mjs �[2m(�[22m�[2m6 tests�[22m�[2m)�[22m�[90m 13�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/role-routing.test.mjs �[2m(�[22m�[2m10 tests�[22m�[2m)�[22m�[90m 19�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/branch-strategy.test.mjs �[2m(�[22m�[2m6 tests�[22m�[2m)�[22m�[90m 14�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/environment.test.mjs �[2m(�[22m�[2m3 tests�[22m�[2m)�[22m�[90m 16�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/role-attribution.test.mjs �[2m(�[22m�[2m16 tests�[22m�[2m)�[22m�[90m 25�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/extension-packs.test.mjs �[2m(�[22m�[2m8 tests�[22m�[2m)�[22m�[90m 115�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-replay.test.mjs �[2m(�[22m�[2m4 tests�[22m�[2m)�[22m�[90m 32�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-domain.test.mjs �[2m(�[22m�[2m9 tests�[22m�[2m)�[22m�[90m 22�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-security-graph.test.mjs �[2m(�[22m�[2m5 tests�[22m�[2m)�[22m�[90m 16�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/integration-lifecycle.test.mjs �[2m(�[22m�[2m4 tests�[22m�[2m)�[22m�[90m 49�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/release-versioning.test.mjs �[2m(�[22m�[2m4 tests�[22m�[2m)�[22m�[90m 88�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-read-model.test.mjs �[2m(�[22m�[2m3 tests�[22m�[2m)�[22m�[90m 21�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/issue-markdown.test.mjs �[2m(�[22m�[2m6 tests�[22m�[2m)�[22m�[90m 12�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-goal-model.test.mjs �[2m(�[22m�[2m3 tests�[22m�[2m)�[22m�[90m 17�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/cockpit-config-github.test.mjs �[2m(�[22m�[2m3 tests�[22m�[2m)�[22m�[90m 14�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/collaboration-plan.test.mjs �[2m(�[22m�[2m5 tests�[22m�[2m)�[22m�[90m 12�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/collaboration-evidence.test.mjs �[2m(�[22m�[2m4 tests�[22m�[2m)�[22m�[90m 10�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/release-closeout.test.mjs �[2m(�[22m�[2m2 tests�[22m�[2m)�[22m�[90m 8�[2mms�[22m�[39m
�[32m✓�[39m scripts/tests/cli.test.mjs �[2m(�[22m�[2m4 tests�[22m�[2m)�[22m�[33m 3227�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m CLI extension helpers�[2m > �[22mlists, inspects, enables, disables, and validates packs deterministically �[33m1509�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m CLI extension helpers�[2m > �[22mlists, inspects, enables, disables, and validates packs deterministically �[33m1331�[2mms�[22m�[39m
�[32m✓�[39m lib/tests/install.test.mjs �[2m(�[22m�[2m12 tests�[22m�[2m)�[22m�[33m 4125�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22minit installs every framework file and seeds project-owned policy docs �[33m395�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22msync run twice with no local edits produces no framework diff on the second run �[33m433�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22msync installs a framework file that did not exist in the target yet �[33m696�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22msync reports a file the project intentionally deleted as removedByProject, without recreating it �[33m471�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22minit and doctor report discovered extension packs without enabling them �[33m473�[2mms�[22m�[39m
�[33m�[2m✓�[22m�[39m init/sync/doctor�[2m > �[22mdoctor reports missing and invalid enabled extension packs �[33m505�[2mms�[22m�[39m

�[2m Test Files �[22m �[1m�[32m21 passed�[39m�[22m�[90m (21)�[39m
�[2m Tests �[22m �[1m�[32m132 passed�[39m�[22m�[90m (132)�[39m
�[2m Start at �[22m 20:01:48
�[2m Duration �[22m 5.20s�[2m (transform 899ms, setup 0ms, collect 3.30s, tests 7.87s, environment 9ms, prepare 3.54s)�[22m.

  • Manual docs/product review.
  • Link check for changed docs.

Workflow classification

Docs/QA closeout issue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    awaiting-releaseManaged by multi-agent-sdlc integration lifecycle automationdocumentationImprovements or additions to documentationdrafted-by:piIssue drafted by Piintegrated:developmentManaged by multi-agent-sdlc integration lifecycle automationproduct:cockpitAgentFlow Cockpit optional Goal Command Centerproduct:docsPublic documentation, onboarding, IA, examplesproduct:harnessHarness adapters, plugins, skills, settings, execution targetsproduct:releaseRelease readiness, npm packaging, versioning, sandbox gatesqaExploratory QA sessions, QA planning/execution, or QA evidence workrelease:v1.0.0Assigned to AgentFlow SDLC v1 releasestatus:v1-readyImplemented on development and awaiting v1 release

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions