velvet plugin

Agent plugin (plugin.json version 1.0.0) that teaches coding agents to keep a Velvet work log with the velvet CLI.

Interface

• plugin.json and .claude-plugin/plugin.json: manifests. The OpenAI extension sets onboardingSkill to ./skills/setup/SKILL.md.
• Skills:
  • setup: link a repository to one Velvet project.
  • log-work: velvet log after meaningful work.
  • tickets: find, create, edit, assign, comment, list evidence.
  • sprints: sprints and milestones.
  • recap: velvet recap --days N, reports, mentions.
  • attach-image: velvet upload-image to one ticket or milestone.
  • management: account-wide admin via velvet admin login.

Invariants

• Each repository key reaches only its linked project from velvet.yaml.
• Management requires separate consent and never reuses setup, project, or VELVET_TOKEN credentials.
• Skills must name only real CLI commands, and every CLI command must appear in some skill. Enforced by TestPluginSkillsNameOnlyRealCommands in cli/cmd/velvet/main_test.go.

Verification

cd cli && go test ./cmd/velvet -run TestPluginSkillsNameOnlyRealCommands

Side effects

• None. Documentation and manifests only.