codex-agent-repository-kit/manifest.json

{
  "name": "codex-agent-repository-kit",
  "version": "1.0.0",
  "description": "Universal repository baseline for Codex-assisted projects.",
  "agentResponsibilities": [
    "Read manifest.json before copying files.",
    "Use copyMap target paths unless the repository already has an equivalent convention.",
    "At the start of each user-requested task, check for upstream repository updates and apply them immediately with a safe fast-forward pull when the working tree is clean.",
    "Check git status before editing and before finishing.",
    "Preserve unrelated user changes.",
    "Replace applicable placeholders and remove non-applicable placeholder sections.",
    "Keep AGENTS.md and .codex/project.md aligned with real commands and artifact paths.",
    "Update README.md whenever blueprint.md or blueprint.json changes.",
    "Update docs/security-review.md during release-readiness work.",
    "Update docs/release-checklist.md when release behavior changes.",
    "Add or preserve non-destructive scheduled repository cleanup checks for active projects.",
    "Add or preserve dependency, release dry-run, and template compliance checks when they fit the project.",
    "Run git diff --check before finishing.",
    "Run the cheapest reliable verification command or document why it could not run.",
    "After pushing workflow-triggering commits, poll Gitea workflow runs until success or a concrete blocker."
  ],
  "securityAutomation": {
    "workflow": "files/security-scan-gitea.yml",
    "target": ".gitea/workflows/security-scan.yml",
    "schedule": "weekly",
    "checks": [
      "stack-specific dependency audit",
      "suspicious code pattern scan",
      "secret and config leak scan",
      "AI instruction injection scan"
    ]
  },
  "cleanupAutomation": {
    "workflow": "files/repo-cleanup-gitea.yml",
    "target": ".gitea/workflows/repo-cleanup.yml",
    "schedule": "weekly",
    "checks": [
      "tracked generated files",
      "large tracked files",
      "secret-prone local config files",
      "stale branch candidates"
    ],
    "destructive": false
  },
  "dependencyAutomation": {
    "workflow": "files/dependency-check-gitea.yml",
    "target": ".gitea/workflows/dependency-check.yml",
    "schedule": "weekly",
    "checks": [
      "dependency vulnerability reports",
      "outdated dependency reports",
      "Docker base image references"
    ],
    "destructive": false
  },
  "releaseDryRunAutomation": {
    "workflow": "files/release-dry-run-gitea.yml",
    "target": ".gitea/workflows/release-dry-run.yml",
    "trigger": "push and manual",
    "checks": [
      "release documentation presence",
      "unresolved placeholder scan",
      "stack-specific build/test checks",
      "artifact discovery"
    ],
    "publishes": false
  },
  "templateComplianceAutomation": {
    "workflow": "files/template-compliance-gitea.yml",
    "target": ".gitea/workflows/template-compliance.yml",
    "trigger": "push, pull request, and manual",
    "checks": [
      "required Codex files",
      "unresolved placeholders",
      "README divider convention",
      "recommended workflow presence"
    ],
    "destructive": false
  },
  "readmeDivider": {
    "templateName": "section-line",
    "source": "https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png",
    "usage": "Keep {{ template:section-line }} between major sections in generated README files."
  },
  "workflows": {
    "newRepository": "new-repository.md",
    "existingProject": "existing-project.md",
    "quickstart": "agent-quickstart.md"
  },
  "schema": "manifest.schema.json",
  "copyMap": [
    {
      "source": "files/AGENTS.md",
      "target": "AGENTS.md",
      "required": true
    },
    {
      "source": "files/project.md",
      "target": ".codex/project.md",
      "required": true
    },
    {
      "source": "files/SECURITY.md",
      "target": "SECURITY.md",
      "required": false
    },
    {
      "source": "files/CHANGELOG.md",
      "target": "CHANGELOG.md",
      "required": false
    },
    {
      "source": "files/CONTRIBUTING.md",
      "target": "CONTRIBUTING.md",
      "required": false
    },
    {
      "source": "files/gitignore.template",
      "target": ".gitignore",
      "required": false
    },
    {
      "source": "files/agent-handoff.md",
      "target": "docs/agent-handoff.md",
      "required": false
    },
    {
      "source": "files/release-notes.md",
      "target": "docs/release-notes.md",
      "required": false
    },
    {
      "source": "files/release-checklist.md",
      "target": "docs/release-checklist.md",
      "required": false
    },
    {
      "source": "files/security-review.md",
      "target": "docs/security-review.md",
      "required": false
    },
    {
      "source": "files/blueprint.md",
      "target": "blueprint.md",
      "required": false
    },
    {
      "source": "files/blueprint.json",
      "target": "blueprint.json",
      "required": false
    },
    {
      "source": "files/build-gitea.yml",
      "target": ".gitea/workflows/build.yml",
      "required": false
    },
    {
      "source": "files/security-scan-gitea.yml",
      "target": ".gitea/workflows/security-scan.yml",
      "required": false
    },
    {
      "source": "files/repo-cleanup-gitea.yml",
      "target": ".gitea/workflows/repo-cleanup.yml",
      "required": false
    },
    {
      "source": "files/dependency-check-gitea.yml",
      "target": ".gitea/workflows/dependency-check.yml",
      "required": false
    },
    {
      "source": "files/release-dry-run-gitea.yml",
      "target": ".gitea/workflows/release-dry-run.yml",
      "required": false
    },
    {
      "source": "files/template-compliance-gitea.yml",
      "target": ".gitea/workflows/template-compliance.yml",
      "required": false
    }
  ],
  "placeholders": [
    "PROJECT_NAME",
    "PROJECT_DESCRIPTION",
    "REPOSITORY_OWNER",
    "REPOSITORY_NAME",
    "PACKAGE_NAME",
    "ARTIFACT_NAME",
    "ARTIFACT_OUTPUT_DIRECTORY",
    "AUTHOR_NAME",
    "PROJECT_STACK",
    "DOWNLOAD_URL",
    "BUILD_COMMAND",
    "TEST_COMMAND",
    "LINT_COMMAND",
    "AUDIT_COMMAND",
    "README_COMMAND",
    "INSTALL_COMMAND",
    "DEV_COMMAND",
    "PACKAGE_MANAGER",
    "PROJECT_VERSION"
  ],
  "profiles": [
    {
      "name": "node",
      "path": "profiles/node.md"
    },
    {
      "name": "electron",
      "path": "profiles/electron.md"
    },
    {
      "name": "python",
      "path": "profiles/python.md"
    },
    {
      "name": "docker",
      "path": "profiles/docker.md"
    },
    {
      "name": "static-site",
      "path": "profiles/static-site.md"
    }
  ]
}