Artifact Map

VibePro writes evidence into the target repository's .vibepro/ workspace.

Workspace layout

.vibepro/
  config.json
  vibepro-manifest.json
  checks/
  diagnostics/
  doctor/
  executions/
  explore/
  graphify/
  harness/
  journey/
  manual-verification/
  pr/
  qa/
  raw/
  reviews/
  spec/
  stories/
  verification-artifacts/

Directory guide

Directory	Purpose
.vibepro/checks/	check pack results and summaries
.vibepro/diagnostics/	diagnosis runs and repository findings
.vibepro/doctor/	workspace health checks and repair hints
.vibepro/executions/	multi-step execution state, managed worktree state, merge audit
.vibepro/explore/	investigation prompts, records, and status
.vibepro/graphify/	imported Graphify graph files and report
.vibepro/harness/	agent harness coverage and learning candidates
.vibepro/journey/	journey map JSON and Markdown output
.vibepro/manual-verification/	manually recorded focused verification artifacts
.vibepro/pr/	PR preparation, Gate DAG, review cockpit, split plan, PR create/merge state
.vibepro/reviews/	Agent Review lifecycle, result, summary, and history
.vibepro/spec/	inferred Spec files and drift context
.vibepro/stories/	active and archived Story metadata, reports, plans, task outputs
.vibepro/verification-artifacts/	verification records, CI imports, and linked evidence

PR artifacts

The main PR artifacts live under:

.vibepro/pr/<story-id>/

Important files:

Artifact	Audience	Purpose
pr-body.md	humans and agents	PR body draft with story, risks, gates, and verification context
review-cockpit.html	humans	review dashboard for current readiness
gate-dag.html	humans	visual readiness dependency graph
split-plan.html	humans	PR split lanes and merge order
pr-prepare.json	agents and tools	machine-readable source of truth for PR readiness

Verification records

Verification records capture command, status, target story, and optional artifacts. They should be current-bound to the git state being prepared for PR.

Use:

vibepro verify record /path/to/repo \
  --id <story-id> \
  --kind <unit|integration|e2e|typecheck|build> \
  --status <pass|fail|needs_setup> \
  --command "<command>"

Review records

Review records capture role, stage, status, summary, findings, and agent lifecycle metadata when required.

Use:

vibepro review status /path/to/repo --id <story-id>

to inspect missing, stale, or blocking review evidence.

Decision records

Decision records explain accepted risk, waivers, noise classifications, and other review decisions.

Use:

vibepro decision status /path/to/repo --id <story-id>

to inspect active decisions for a story.

Graphify artifacts

Graphify imports are advisory impact context:

.vibepro/graphify/
  graph.json
  graph.html
  GRAPH_REPORT.md

Use these files to inspect connected functions, communities, and possible blast radius before deciding which checks or reviews are required.