Skip to content

zafrirron/Agent-Platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

178 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Platform Bootstrap

Built by agents. For agents. To build better agents.

The meta-platform: an AI agent maintains the rules that your AI agents follow. Every upgrade makes every agent smarter. Agents building the platform that builds better agents.

License: Elastic-2.0 © 2024–2026 Zafrir Ron — Free for personal and internal use. Commercial hosting/SaaS prohibited. See LICENSE.

📊 View Interactive Presentation — interactive deck · lifecycle · live demo · enterprise features


What it is

A complete multi-agent development environment installed into any repository in one command. Claude Code, Cursor, Antigravity, and Codex work together without conflicts. Nine expert agents (including the Critic — adversarial reviewer). 20 playbooks. 11 lifecycle skills. Three install profiles (lite / core / full). Test enforcement. A quick reference on every session start. No memorisation required.

Lifecycle: DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP (full profile adds session handoff + enterprise gates)

The platform coordination layer never modifies your source code. It only adds .agent/, .claude/, etc. — all gitignored so nothing is accidentally committed. Your AI agents will write and improve your code through the platform. That's the point. The platform scaffolding itself stays completely out of your codebase. Already using Claude Code, Cursor, Antigravity, or Codex? Your existing CLAUDE.md, AGENTS.md, and Cursor rules are preserved, backed up, and never overwritten. Remove the platform and your originals are restored.


Security and trust — what this platform is and is not

The platform installs markdown files. That is all.

Expert rules and playbooks are plain-text instructions that tell AI agents how to write better, more secure code. They are not executable code. They do not run inside your project. They cannot exfiltrate data, add backdoors, or weaken your security posture.

Concern Reality
Injects executable code into my project ❌ Only markdown, YAML, and JSON files are installed
Modifies my source code or config ❌ Installer creates new files only — existing files skipped
Makes network calls from my project ❌ No runtime dependencies are added
Collects telemetry or sends data anywhere ❌ No analytics, no tracking, no callbacks
Commits anything without my knowledge ❌ All platform files are gitignored on install
Overwrites my security decisions ❌ Your PROJECT sections are never overwritten

Every rule is readable and auditable. Open any file in .agent/agents/ — every instruction the platform gives your AI is visible markdown. Every rule traces to its source failure in MAINTAINER/platform-improvements.md.

No npm registry, no third-party dependencies. apply.js uses only Node.js built-ins (fs, path). Nothing from the npm registry that could be compromised.

→ Full security declaration: SECURITY.md


Zero footprint — install, use, remove cleanly

Guarantee Detail
No code changes on install Only adds .agent/ .claude/ .cursor/ .agents/ .codex/ folders and AGENTS.md SYNC-POINTS.md CLAUDE.md. Zero modifications to your existing files.
Nothing committed accidentally All platform folders and files are added to .gitignore automatically on install. git status stays clean. Your team never sees platform noise.
Existing AI configs are preserved Already using Claude Code, Cursor, Antigravity, or Codex? Your CLAUDE.md, AGENTS.md, Cursor rules, and any other AI config files are never overwritten. Backed up to .agent/backup/. A MIGRATION-NOTES.md explains how to connect them to the platform.
Clean removal --mode=uninstall removes all platform AI coordination files and restores your original AI configs from backup. The platform coordination layer never modifies your source code — your AI agents write code for you, the platform just makes them smarter.
Your customisations survive upgrades mode=upgrade only updates the <!-- PLATFORM:START/END --> section of each file. Your project-specific content is never overwritten.

Install

Three profiles — same lifecycle skills, different coordination depth. Pick based on team size and how much structure you want on day one.

Profile Command Best for
lite (skills pack) npx github:zafrirron/Agent-Platform --profile=lite --framework=cursor Solo dev, Cursor or Claude, skills-first workflow
core npx github:zafrirron/Agent-Platform --profile=core Full playbooks + experts, no enterprise/compliance layer
full (default) npx github:zafrirron/Agent-Platform Teams, multi-IDE handoff, session registry, enterprise gates

Which profile should I use?

You are… Recommended Why
Solo dev trying Agent Platform or coming from skill packs lite Same /spec/ship lifecycle, minimal footprint — skills + slash commands only
Cursor user, no plugin marketplace lite + --framework=cursor Installs .cursor/commands/ and .agent/skills/ — see docs/cursor-setup.md
Claude Code user wanting skills only lite or marketplace plugin Plugin = skills pack; npx --profile=lite adds project-local commands
One dev who wants playbooks + expert routing core or full Experts and 20 playbooks auto-load from plain-language tasks
Team on multiple IDEs (Cursor + Claude + …) full Session handoff, CURRENT.md, conflict registry, cross-IDE Critic review
Need NFR, compliance, PRR, org maturity playbooks full Enterprise playbook layer not included in lite or core

What each profile includes

Capability lite core full
11 lifecycle skills + /spec/verify /ship
Slash commands (Cursor / Claude)
Cherry-pick --mode=add --add=skill:…
9 expert agents + auto-routing
20 playbooks (bug-fix, release, debug, …)
Session start/end + handoff (CURRENT.md)
Multi-IDE sync registry
Enterprise playbooks (NFR, compliance, PRR, …)
/audit · /release · /implement (Plan handoff)
Optional CI guards (--mode=install-guards)

Start lite, grow into full: lite is not a dead end — upgrade anytime without losing skills:

npx github:zafrirron/Agent-Platform --profile=full

Your project-specific content in AGENTS.md / CLAUDE.md PROJECT sections is preserved on upgrade.

# Any OS — Node.js 18+
npx github:zafrirron/Agent-Platform

# Cherry-pick one skill
npx github:zafrirron/Agent-Platform --mode=list --list=skills
npx github:zafrirron/Agent-Platform --mode=add --add=skill:interview-me --framework=cursor

# Claude Code marketplace plugin (skills + commands)
# /plugin marketplace add https://github.com/zafrirron/Agent-Platform.git
# /plugin install agent-platform-skills@zafrirron

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/zafrirron/Agent-Platform/main/install.sh | bash

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/zafrirron/Agent-Platform/main/install.ps1 | iex

Cursor has no plugin marketplace — use npx or see docs/cursor-setup.md.

Start your first session — one command, any IDE:

Read .agent/session-start.md and execute it.

Quick reference — commands, experts, and playbooks

Install creates .agent/QUICK-REF.md — the full capability guide for your project. It lists every command, every expert agent, every playbook, and every platform operation.

Ask your agent at any time to show it:

Say this What happens
"show quick reference" Agent returns a clickable link to .agent/QUICK-REF.md
"show help" Same
"show commands" Same
"what can you do" Same
"platform help" Same

The agent responds with a link — it does not dump the file into chat (that would waste your context window). Open the file in your editor to see everything at a glance.

Slash commands (type / in chat) — full lifecycle:

/spec · /plan · /build · /test · /review · /code-simplify · /webperf · /context · /verify · /ship (+ /audit /release on full profile)

  • Cursor.cursor/commands/: above + /session-start · /session-end · /implement (Plan handoff) · /platform-help · /caveman
  • Claude Code.claude/commands/: lifecycle set + marketplace plugin agent-platform-skills

Skills (cherry-pick under .agent/skills/): all 11 lifecycle skills — see .agent/QUICK-REF.md for when to use each (/webperf, /context, /verify, etc.)

What's in the guide: session commands · profiles (lite/core/full) · 9 expert agents · 20 playbooks · 11 lifecycle skills · reference checklists · NFR/compliance · caveman · platform operations


Why Agent Platform (named discipline)

Hard-won engineering habits are encoded into playbooks and experts — not left to model mood:

Concept What it means here
Rationalization gate Playbooks block "skip this step because…" excuses
Doubt review Architect challenges the design before code lands
Beyoncé Rule Tests assert behavior, not private implementation
Hyrum's Law Backend agent treats every response shape as a public contract
Chesterton's Fence Refactor playbook: understand legacy before deleting
Critic (10 dimensions) Adversarial review across security, a11y, operability, BC

vs skill packs: Portable skills teach how to think; Agent Platform adds where work happens — session handoff, multi-IDE registry, gated workflows, optional CI guards. See docs/DISTRIBUTION.md and CONTRIBUTING.md.


The meta-philosophy

Most tools make developers more productive. This platform makes AI agents more disciplined, consistent, and safe — by encoding hard-won lessons from real software failures into permanent rules that every agent follows, in every project, automatically.

The platform itself is developed using the same platform. An AI agent maintains the expert rules. Another AI applies them in your project. When we improve a rule, every user's agents improve on next upgrade.

You observe a failure in a real project
        ↓
AI partner (platform maintainer agent) helps diagnose and write the rule
        ↓
Rule ships in the next version
        ↓
Every user's agents are now smarter — automatically
        ↓
Repeat. The platform never stops improving.

Agents writing the rules. Rules making agents better. Better agents building better software.


What you get

Capability Description
4 IDE frameworks Claude Code · Cursor · Antigravity · Codex — coordinated, no conflicts
9 expert agents Architect · Backend · Frontend · DevOps · Test · Docs · Security · Data · Critic — activate by name
Critic agent Adversarial reviewer — finds bugs, security issues, edge cases, and test gaps that implementing agents miss. Built into bug-fix, add-feature, and release playbooks.
Cross-framework critic review When you switch IDEs (e.g. Claude Code → Cursor), the new agent automatically offers to review the previous model's work. Different AI models have different blind spots — cross-model review catches what the first model missed. Zero extra setup.
Emergency IDE takeover If an IDE runs out of credits or crashes mid-session, just start a session in any other IDE. It detects the stuck session, offers to take over, commits any uncommitted work, and continues — no manual file editing, no lost work. Switch between Claude Code, Cursor, Codex, and Antigravity freely based on credits and availability.
🔍 Full Project Audit 11-phase professional report on first session or on demand — architecture through governance/maturity. Report saved to .agent/context/audit-[date].md. Ideal for onboarding to any unknown repo.
20 playbooks Core: audit · add-feature · bug-fix · refactor · release · debug · security-audit · add-dependency · api-integration · document-api · deprecation · requirements-clarification. Quality: nfr-definition · production-readiness · performance-budget · observability-setup · accessibility-audit. Compliance: compliance-review · org-maturity-assessment · incident-postmortem
Reference checklists .agent/references/ — testing, security, performance, accessibility, orchestration patterns (agent-skills–informed)
Install profiles lite skills pack · core (no enterprise) · full team platform · --mode=add cherry-pick
11 lifecycle skills SKILL.md modules — interview-me, TDD, plan/build slices, code-simplify, web-performance-audit, context-engineering, verification-before-completion
Agent-skills ingest Rationalization gates · doubt review · source-driven dev · Beyoncé/DAMP · spec-outline template
NFR & production readiness nfr-log.md — measurable ISO 25010 targets. production-readiness gates go-live (P0 NFRs, compliance evidence, vuln SLA).
Compliance & DORA compliance-evidence-log.md for SOC 2 / ISO 27001 artifacts. Maturity assessment + incident postmortem for DORA metrics.
Smart upgrade model mode=upgrade improves your agents' rules without touching your project customisations
Code standards enforcement SOLID principles · DRY · file modularity · no magic numbers · linting gates · branching strategy — encoded into expert agents and CONVENTIONS.md. Architect agent runs SOLID checks at design time. Critic catches DRY violations. DevOps agent blocks the pipeline on lint failures — not a suggestion, a gate.
Test enforcement Every function, bug fix, and API endpoint requires a test. Red suite blocks handoff. Test expert auto-generates coverage in 4 formats: HTML (coverage/lcov-report/index.html — open in browser), Clover XML (Jenkins/CI), LCOV (Codecov/Coveralls), and JSON. All formats generated from one --coverage run.
API documentation Docs expert generates OpenAPI/Swagger docs from api-contracts.md. Say "document the API" and get a publish-ready spec.
Quick reference Compact status block on every session start (last work, update status). Full capability guide at .agent/QUICK-REF.md — open in editor any time. No memorisation required.
Local help PLATFORM-HELP.md installed in every repo — everything explained, fully offline
Agentic update check Agents check for platform improvements automatically, once per 7 days
Docs governance Every doc has a registered owner expert. Done-when checklists enforce updates. Session end catches new unregistered files. Release playbook blocked until Docs agent approves all docs current. New docs added by users are detected automatically and added to the registry.
Token compression "caveman mode" — ~65% shorter output, same accuracy, all IDEs
Enforcement guards --mode=install-guards wires real pre-commit hooks and GitHub Actions CI — secrets scan, test suite, coverage gate, unregistered doc detection. Aspiration becomes enforcement.
Zero code impact Installs only into .agent/ .claude/ .cursor/ .agents/ .codex/. Nothing else changes. All platform files gitignored by default. Remove completely with one command — nothing left behind.

How it works

┌─────────────────────────────────────────────────────────────────────┐
│  INSTALL  (once)                                                      │
│  npx github:zafrirron/Agent-Platform                                 │
│                                                                       │
│  Detects stack · Installs .agent/ .claude/ .cursor/ .agents/ .codex/ │
│  Backs up any existing AI configs · Gitignores platform files        │
│  Prints: capability list + one session-start command                 │
└──────────────────────────────────┬──────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────┐
│  SESSION START  (every session, any IDE)                              │
│  "Read .agent/session-start.md and execute it."                      │
│                                                                       │
│  · Conflict check — is another IDE already active?                   │
│  · Cross-framework Critic offer — if switching from another IDE      │
│  · Update check — once per 7 days, cached                           │
│  · Compact status block — last work, update status, quick ref path  │
│  · "Ready. Tell me what you want to do."                             │
└──────────────────────────────────┬──────────────────────────────────┘
                                   │
                      You describe what you want
                                   │
              Auto-routing: agent identifies task type, declares the match
              (▶ Expert · playbook), then begins — user just describes the goal
                                   │
              ┌────────────────────┴─────────────────────┐
              │                                           │
              ▼                                           ▼
┌─────────────────────────┐◄──── COMBINE ────►┌───────────────────────────┐
│  EXPERT AGENT           │                   │  PLAYBOOK                 │
│  WHO the agent is       │  Use alone  OR    │  WHAT steps to follow     │
│                         │  load both        │                           │
│  "review for security"  │  together for     │  "fix a bug"              │
│    → Security expert    │  the most         │    → bug-fix.md           │
│                         │  powerful result  │                           │
│  "find what's wrong"    │                   │  "ready to ship"          │
│    → Critic agent       │                   │    → release.md           │
└────────────┬────────────┘                   └─────────────┬─────────────┘
             └──────────────────┬──────────────────────────┘
                                ▼
              ┌──────────────────────────────────────────────────────────┐
              │  COMBINED EXAMPLE: "fix the login bug"                    │
              │                                                            │
              │  Backend expert  +  bug-fix.md                            │
              │  (WHO: API rules,   (WHAT: reproduce → root cause →       │
              │  auth discipline,    fix → regression test → critic)      │
              │  done-when gates)                                          │
              │                                                            │
              │  Expert rules govern every step.                          │
              │  At Step 5b the playbook assigns the Critic agent.        │
              └──────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────────┐
│  WORK                                                                 │
│                                                                       │
│  Agent reads context files — api-contracts, adr-log, known-issues   │
│  Agent checks patterns.md — reuses what worked in prior sessions    │
│  Agent follows rules — CONVENTIONS.md, BEST-PRACTICES.md            │
│  Agent writes code, tests, documentation                             │
│  Security gate — automatic for new endpoints/auth (add-feature 5a)  │
│  Critic review gate (mandatory quality gate in every playbook)       │
│  Test suite runs and passes · Coverage report generated              │
└──────────────────────────────────┬──────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────┐
│  SESSION END                                                          │
│  "Read .agent/session-end.md and execute it."                        │
│                                                                       │
│  · Summarise work — derived from context, no user recap needed       │
│  · Pre-handoff checklist — tests green, no stubs, docs updated      │
│  · Commit all uncommitted changes — clean handoff to next IDE        │
│  · Capture reusable pattern in patterns.md (if session solved        │
│    something non-trivial — agents build codebase memory over time)   │
│  · Update CURRENT.md — goal, files, commit hash, Critic reviewed: no│
│  · Mark framework idle in registry                                   │
└──────────────────────────────────┬──────────────────────────────────┘
                                   │
              ┌────────────────────┴─────────────────────┐
              │                                           │
              ▼                                           ▼
   Same IDE next session                      Switch to another IDE
   Back to SESSION START                      SESSION START in new IDE
                                              + Critic reviews prior work

Cross-framework critic review — automatic multi-model code review

When you switch IDEs, the platform turns the framework switch into a code review.

Claude Code session:
  You implement a feature, end session.
  CURRENT.md records: files changed, goal, Critic reviewed: no

You open Cursor, run session-start:

  ┌─────────────────────────────────────────────────────────────┐
  │  Cross-framework Critic review available                    │
  │  Last session: Claude Code — "Add JWT refresh endpoint"     │
  │  Files: src/api/auth.ts, src/api/auth.test.ts               │
  │  Review before we proceed?  YES / NO                        │
  └─────────────────────────────────────────────────────────────┘

  YES → Cursor reviews Claude Code's work with fresh eyes.
        No shared context. No shared assumptions.
        Reports: findings by severity → you decide what to fix.

Why it matters: A different AI model (Claude vs GPT vs Gemini) has different reasoning patterns and blind spots. When Cursor reviews Claude Code's work, it approaches the code the way a second developer would — cold, without the assumptions the first model built up during implementation. This catches auth gaps, untested edge cases, and intent-vs-implementation mismatches that single-model review consistently misses.

Zero setup required. It just happens automatically whenever meta.updated_by in the registry doesn't match the framework you're starting.


Global install — platform everywhere (optional, run once)

Install user-level stubs to your home directory so the platform activates automatically in every repo:

npx github:zafrirron/Agent-Platform --mode=global

Writes to ~/.claude/CLAUDE.md, ~/.claude/commands/, ~/.cursor/rules/, ~/.cursor/commands/, ~/.codex/instructions.md, ~/.agents/rules/ — all four frameworks.

What it does:

  • Repo with platform installed → expert routing activates automatically, no manual session-start needed
  • Repo without platform → one-time install offer displayed at session start
  • Repo with .agent-platform-skip → offer suppressed permanently for that repo
  • ~/.claude/commands/ and ~/.cursor/commands/ → lifecycle slash commands (/session-start, /spec, /audit, /ship, /implement, /caveman, …) available in every repo globally

The three-layer model after global install:

Layer Where What
PLATFORM project .agent/agents/*.md Framework-maintained expert rules
PROJECT project .agent/agents/*.md Your team's coding conventions
USER ~/.claude/CLAUDE.md USER section Your personal cross-repo preferences

USER section is yours — never overwritten by upgrades.


Upgrade — get smarter agents

# Your agents get improved rules. Your project customisations are untouched.
npx github:zafrirron/Agent-Platform --mode=upgrade

Every expert file has two sections:

  • Platform section — improved by this project, pushed on --mode=upgrade
  • Project section — your team's rules, never overwritten

Why upgrading is worth it: Every release includes rules sourced from four places — OWASP security guidelines and CWE Top 25 (Mode 2 web audit), real failures observed in production codebases (Mode 1), production-proven rules contributed by platform users (Mode 3), and new governance patterns discovered through quarterly GitHub ecosystem scans (Mode 4). When you upgrade:

  • Your Security expert knows the latest OWASP API vulnerabilities and CWE patterns
  • Your Backend expert knows current API design standards
  • Your Test expert knows current testing quality requirements
  • Your Critic agent knows what to look for in adversarial review
  • Your platform governance reflects the best coordination patterns from the open-source ecosystem

You don't track these sources yourself — the platform does it for you, and every upgrade makes your agents smarter.

Platform fork maintainers: the full improvement pipeline (Mode 1–4 commands, ingest workflow, governance scan) is documented in MAINTAINER/GUIDE.md.


Enforcement guards — wired, not aspirational

The expert rules tell agents what to do. The guards ensure it actually happens.

npx github:zafrirron/Agent-Platform --mode=install-guards

Installs:

  • Pre-commit hook — blocks commits containing secrets or with a failing test suite
  • GitHub Actions CI — blocks PRs with failing tests, coverage below threshold, or secrets

Stack-aware: auto-detects your test runner and generates the right CI setup steps.

npx github:zafrirron/Agent-Platform --mode=remove-guards  # remove if needed

Fork this platform — build your own

This repository is designed to be forked. Teams and enterprises can run their own private instance with custom expert rules, playbooks, and branding.

Why fork?

  • Add your company's internal coding standards as permanent expert rules
  • Add domain-specific expert agents (mobile, ML, compliance, etc.)
  • Run private security audits with your own OWASP extensions
  • Deploy to your team via your own GitHub org: npx github:YOUR_ORG/your-platform
  • Keep proprietary rules out of a public repo

Fork setup — 4 fields to change

Step 1 — Fork and clone:

# Fork on GitHub: click "Fork" on https://github.com/zafrirron/Agent-Platform
git clone https://github.com/YOUR_ORG/YOUR_REPO_NAME.git
cd YOUR_REPO_NAME

Step 2 — Update AGENT-PLATFORM-MANIFEST.json (the only critical change — drives all deployed content):

"platform_repo": "YOUR_ORG/YOUR_REPO_NAME",
"platform_npx":  "github:YOUR_ORG/YOUR_REPO_NAME"

Step 3 — Update package.json:

"name":   "your-platform-name",
"author": "YOUR_ORG",
"repository": {
  "url": "https://github.com/YOUR_ORG/YOUR_REPO_NAME.git"
}

Step 4 — Update install scripts (so your team's install links point to your fork):

In install.sh:

REPO="YOUR_ORG/YOUR_REPO_NAME"

In install.ps1:

$Repo = "YOUR_ORG/YOUR_REPO_NAME"

tools/release.ps1 reads the repo from the manifest automatically — no change needed.

Step 5 — Verify everything is wired:

npm test   # 125 tests must pass

Step 6 — Deploy to your team:

# Your team installs your fork:
npx github:YOUR_ORG/YOUR_REPO_NAME

# Your team upgrades when you release new rules:
npx github:YOUR_ORG/YOUR_REPO_NAME --mode=upgrade

What you keep from upstream

Pull improvements from this repo any time:

git remote add upstream https://github.com/zafrirron/Agent-Platform.git
git fetch upstream
git merge upstream/main

New OWASP rules, expert improvements, and platform features flow in via merge. Your custom rules in <!-- PROJECT:START/END --> sections are never overwritten.


Remove

npx github:zafrirron/Agent-Platform --mode=uninstall          # dry run — shows what will be removed
npx github:zafrirron/Agent-Platform --mode=uninstall --confirm # removes platform AI files

Removes: all platform AI coordination folders (.agent/, .claude/, etc.), root files, and the gitignore block.
Restores: any AI config files you had before installing (CLAUDE.md, AGENTS.md, Cursor rules, etc.) from the backup.

The platform coordination layer is removed cleanly. Your AI agents improved your code while you used the platform — those changes are yours. The platform scaffolding that made them smarter is what gets removed.


Presentation

👉 View the interactive platform presentation

19 slides · what it is · how it works · expert agents · playbooks · before/after demo · enterprise governance · platform evolution · global install · zero code impact. Navigate with arrow keys or swipe. Works on mobile.

If the link above doesn't work yet (GitHub Pages propagating): open via htmlpreview


Glossary — standards and abbreviations used

The platform references industry standards by name. Click any term for more detail:

Term What it means Learn more
OWASP Open Web Application Security Project — publishes the most widely-used web security risk lists owasp.org
OWASP Top 10 The 10 most critical web application security risks (updated ~every 3 years) owasp.org/Top10
OWASP API Security The 10 most critical API-specific security risks (2023 edition used in this platform) owasp.org/API-Security
OWASP LLM Top 10 Security risks specific to LLM/AI applications (2025 edition) genai.owasp.org
CWE Common Weakness Enumeration — catalog of software security weaknesses; CWE Top 25 = most dangerous cwe.mitre.org
CVE Common Vulnerabilities and Exposures — database of known vulnerabilities in specific software versions cve.mitre.org
SOLID Five object-oriented design principles: Single responsibility, Open/closed, Liskov substitution, Interface segregation, Dependency inversion Wikipedia
DRY Don't Repeat Yourself — don't duplicate logic; extract shared abstractions Wikipedia
ADR Architecture Decision Record — a short document capturing a hard-to-reverse architectural decision and why it was made adr.github.io
OpenAPI / Swagger Industry-standard format for describing REST APIs; Swagger is the tooling ecosystem around it swagger.io
OIDC OpenID Connect — identity layer on top of OAuth 2.0; used for short-lived token authentication in CI/CD (OIDC credentials) openid.net/connect
SBOM Software Bill of Materials — a list of all components in a software build, required for supply chain security cisa.gov/sbom
CSRF Cross-Site Request Forgery — attack that tricks a user's browser into making unwanted requests OWASP CSRF
SSRF Server-Side Request Forgery — attack that makes the server fetch attacker-controlled URLs OWASP SSRF
N+1 A database query anti-pattern: 1 query to get a list + N queries for each item = (N+1) total queries explanation
Clover XML A test coverage report format (originally by Atlassian) consumed by CI tools like Jenkins, GitHub Actions, and Bamboo wikipedia
LCOV Linux Test Project coverage data format — consumed by Codecov, Coveralls, and most CI coverage dashboards lcov.github.io
Codecov / Coveralls Cloud services that track test coverage trends over time and post coverage badges/comments on PRs codecov.io · coveralls.io

Documentation

Document For
AGENT-PLATFORM-FRAMEWORK-README.md Users — complete installation, usage, and extension guide
docs/DISTRIBUTION.md Users — profiles (lite/core/full), slash commands, cherry-pick, vs skill packs
docs/cursor-setup.md Cursor users — no marketplace; npx --profile=lite, --mode=add
CONTRIBUTING.md Contributors — submit rules, playbooks, and doc improvements
presentation/agent-platform-beta.html Users — interactive product deck (profiles, lifecycle skills)
presentation/team-adoption.html Teams — adoption deck + STORY-PLAN.md presenter guide
SECURITY.md Trust — what the platform does and does not do, how to audit it
CHANGELOG.md Users — version history and upgrade paths
MAINTAINER/GUIDE.md Platform author — agentic development workflow, release process

Platform maintainer commands

This platform is developed using itself. All maintenance is done by telling the agent:

What you want Say to your agent
Start a maintainer session Read MAINTAINER/platform-maintainer-agent.md then describe your task
Improve an expert rule (Mode 1) "Add rule to [expert]: [rule]"
Add a quality gate to a playbook "Add quality gate to [playbook] step N: [condition]"
Add a step to a playbook "Add step to [playbook]: [description]"
Add a new expert agent "Add a new expert agent for [domain]"
Add a new playbook "Add a new playbook for [scenario]"
Add a new IDE framework "Add a new framework for [name]"
Check if a topic is covered "Check if [topic] is covered"
Ingest user agentic files (Mode 3) Read MAINTAINER/platform-ingest.md and execute it.
Monthly security + best practice audit (Mode 2) Read MAINTAINER/web-audit.md and execute it.
Quarterly full ecosystem scan Read MAINTAINER/web-audit.md and execute it. scope=full
Internal consistency audit Read MAINTAINER/platform-audit.md and execute it.
Release the next version "Release" — agent reads CHANGELOG, calculates version bump, confirms with you, runs the release script
Sync user-facing docs after a release "Sync user-facing docs for vX.Y.Z" — updates README, FRAMEWORK-README, QUICK-REF, PLATFORM-HELP, presentation deck
Verify playbook inventory & routing "List all playbooks and check AGENTS.md routing is complete"

Version

v2.42.0 · Changelog · GitHub Releases


Agent Platform Bootstrap — https://github.com/zafrirron/Agent-Platform Built by agents. For agents. To build better agents.

About

This repo is an Agent Platform Bootstrap Framework — a portable, multi-framework scaffolding pack that you drop into any project repository to instantly set up a structured AI agent collaboration environment.

Resources

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE
Unknown
COPYING.md

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors