GitHubHelp

pksorensen/pks-vibecheck

★ 0Forks 0ShellGitHub ↗Compare

README

pks-vibecheck

An AI-powered code review assembly line defined as a .agentics/ repo.

Eight specialist agents review your codebase in sequence — each writing to a shared stage git repo — and deliver a Vibe Score with detailed findings posted directly to your GitHub PR or issue.

Stations

# Station Agent Role Timeout
1 INTAKE Technical Intelligence Officer — tech stack, entry points, size metrics 25 min
2 ARCHITECTURE Principal Software Architect — structure, coupling, scalability 30 min
3 CODE QUALITY Senior Code Quality Engineer — naming, complexity, linters 30 min
4 SECURITY Application Security Engineer — secrets, injections, CVEs 30 min
5 TESTING QA Engineer — test suite results, coverage, quality 30 min
6 DOCUMENTATION Developer Experience Engineer — README, setup, API docs 20 min
7 SYNTHESIS Lead Reviewer — weighted Vibe Score (Security 30%, Code Quality 25%, Architecture 20%, Testing 15%, Documentation 10%) 20 min
8 DELIVER Delivery Agent — posts final report to GitHub PR/issue via gh CLI 10 min

Vibe Score Weights

Security        30%
Code Quality    25%
Architecture    20%
Testing         15%
Documentation   10%

A score below 6.0 / 10 is a failing grade.

Run it

Run Vibecheck

Or go directly to the Vibecheck submit page.

Fork and customise

Clone this repo and edit the .agentics/ folder:

  • assembly-line.json — name, version, gates
  • transitions.json — pipeline flow and gate conditions
  • stations/XX-name/station.json — trigger config (timeouts, labels)
  • stations/XX-name/prompt.md — the agent's task prompt (supports {{task.title}} and {{task.description}})
  • stations/XX-name/system.md — appended to the agent's system prompt
  • devcontainer/ — override the .devcontainer for all workers in this assembly line

Then run your custom assembly line via:

https://agentics.dk/run?assembly=https://github.com/your-org/your-assembly-line

Devcontainer

The .agentics/devcontainer/ folder contains the full devcontainer configuration used by all workers:

  • devcontainer.json — VS Code devcontainer config (Docker build, mounts, env)
  • Dockerfile — based on ghcr.io/pksorensen/pks-fullstack-base
  • init-firewall.sh — iptables allowlist (GitHub, npm, Anthropic, Azure AD, Docker Hub)
  • .tmux.conf — tmux config (mouse enabled)

The firewall restricts outbound traffic to a curated allowlist, preventing workers from accessing arbitrary external services.

Contributors

pksorensen

Issues