Examples

Copy-paste starting points for AGS policies, hooks, and commit messages. Adapt names and paths to your repo. Guided flows live in Tutorials; full wiring is in Configuration.

Registry auth

.npmrc ini

@tmrxjd:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${AGS_NPM_TOKEN}

Versioning policy

.ags/versioning.yml yaml

schemaVersion: 1
scheme: semver
packages:
  - name: "@acme/app"
    path: packages/app/package.json
    previousVersion: "1.0.0"
bumpRules:
  file-create: minor
  module-wire: minor
  single-change: patch
  single-fix: patch
  breaking-change: major
  milestone-close: none
changelog:
  path: CHANGELOG.md

Deployment policy

.ags/deployment.yml yaml

schemaVersion: 1
environments:
  - id: local
    requiredChecks: []
    requiredTests: [unit]
    requiredApprovals: 0
  - id: bench
    requiredChecks: [build]
    requiredTests: [unit]
    requiredApprovals: 0
  - id: staging
    requiredChecks: [build, health]
    requiredTests: [unit, e2e]
    requiredApprovals: 1
  - id: production
    requiredChecks: [build, health]
    requiredTests: [unit, e2e]
    requiredApprovals: 1
deploymentOrder:
  - local
  - bench
  - staging
  - production
mergeTarget: main
requireBeforeMerge:
  - bench
  - staging

Data arrays

.ags/data-arrays.yml yaml

schemaVersion: 1
arrays:
  - id: mcp-tools
    path: config/mcp-tools.json
    locator:
      jsonPath: tools
    order: alpha
    uniqueBy: "$value"
    itemKind: string
graphArtifact: docs/data-array-map/latest.json

Canonical registry

.ags/canonical.yml yaml

schemaVersion: 1
concepts:
  - id: versioning-config
    label: Versioning policy
    canonicalPath: .ags/versioning.yml
    kind: config
    mirrors:
      - docs/versioning/
  - id: deployment-config
    label: Deployment policy
    canonicalPath: .ags/deployment.yml
    kind: config
    mirrors:
      - docs/deployment/
graphArtifact: docs/canonical-map/latest.json

Agent commit message

status/checkpoint(…) text

status/checkpoint(auth-middleware): add session refresh helper

Status: checkpoint
Scope: auth-middleware
Commit-Scope: function-create
Not-done: wire helper into request pipeline
Next: module-wire for refresh on 401
Evidence: vitest packages/auth/src/session.test.ts
Token: mid
Graph-ids: none (infra)
User-approved: no
Enforcement: mcp

Validate in a hook

commit-msg ts

# .githooks/commit-msg (sketch)
#!/usr/bin/env node
import { validateAgentCommitMessage } from '@tmrxjd/agent-governance-system/commit-msg';
import { readFileSync } from 'node:fs';

const msg = readFileSync(process.argv[2], 'utf8');
const result = validateAgentCommitMessage(msg);
if (!result.ok) {
  console.error(result.errors.join('\n'));
  process.exit(1);
}

Programmatic validate ts

import { validateAgentCommitMessage } from '@tmrxjd/agent-governance-system/commit-msg';

const result = validateAgentCommitMessage(message);
if (!result.ok) {
  console.error(result.errors);
  process.exit(1);
}

Changelog fragment

## 1.2.0
- feat(auth): session refresh helper
- fix(auth): clear stale token on 401

## 1.1.1
- fix(pointer): correct docs home for routes/