@spotsccc/agents-framework

@spotsccc/agents-framework is an npm package that installs the agents-framework CLI for bootstrapping backlog-driven working agreements for coding agents inside a repository.

What It Sets Up

The CLI turns agent workflow conventions into repository assets:

• detects existing .agents, .claude, AGENTS.md, and CLAUDE.md configuration
• installs backlog skills for research, planning, readiness review, and execution
• scaffolds a shared markdown backlog in .agents/backlog
• creates or updates managed blocks in AGENTS.md and CLAUDE.md

The result is a repository where agent work can be routed through durable backlog artifacts instead of chat-only context.

Requirements

• Node.js >=22.12.0

Usage

Run without installing globally:

npx @spotsccc/agents-framework init

Target a specific repository:

npx @spotsccc/agents-framework init --cwd /path/to/project

Install as a project dependency and use the local binary through npm exec:

npm install -D @spotsccc/agents-framework
npm exec agents-framework -- init

Overwrite managed files when you intentionally want to refresh generated content:

npx @spotsccc/agents-framework init --force

Current Scope

The current release focuses on the backlog bootstrap flow:

• agents-framework init
• backlog-only starter skills
• backlog templates and directory structure
• safe managed-block upserts for AGENTS.md and CLAUDE.md

Local Development

Run commands from apps/agents-framework:

vp check
vp test
vp pack

Build and execute the local CLI directly:

vp pack
node dist/cli.mjs init --cwd /path/to/project