Agent Customization Pack V1

{
  "schemaVersion": "workspai-agent-customization-pack-capabilities.v1",
  "presets": {
    "minimal": {
      "meaning": "Generate the portable grounding index, AGENTS.md, and provider-specific lightweight instructions.",
      "requiredOutputs": [
        ".workspai/reports/INDEX.json",
        ".workspai/reports/agent-customization-pack.json",
        "AGENTS.md"
      ]
    },
    "enterprise": {
      "meaning": "Generate the full VS Code-native pack: instructions, prompts, skills, custom agents, and validation metadata.",
      "requiredOutputs": [
        ".workspai/reports/INDEX.json",
        ".workspai/reports/agent-customization-pack.json",
        "AGENTS.md",
        ".github/instructions/workspai-workspace.instructions.md",
        ".github/prompts/workspai-diagnose.prompt.md",
        ".github/skills/workspai-workspace-intelligence/SKILL.md",
        ".github/agents/workspai-advisor.agent.md",
        ".workspai/reports/workspai-mcp-design.json",
        ".workspai/reports/workspace-skills-index.json"
      ]
    }
  },
  "targets": {
    "all": {
      "meaning": "Generate every supported customization surface.",
      "outputFamilies": [
        "portable",
        "vscode",
        "copilot",
        "cursor",
        "claude"
      ]
    },
    "vscode": {
      "meaning": "Generate VS Code-native customizations for Copilot Chat and agent workflows.",
      "outputFamilies": [
        "instructions",
        "prompts",
        "skills",
        "agents",
        "hooks"
      ]
    },
    "agents": {
      "meaning": "Generate portable AGENTS.md grounding for any agent.",
      "outputFamilies": [
        "portable"
      ]
    },
    "copilot": {
      "meaning": "Generate GitHub Copilot instructions, prompts, and skills.",
      "outputFamilies": [
        "instructions",
        "prompts",
        "skills"
      ]
    },
    "cursor": {
      "meaning": "Generate Cursor rules.",
      "outputFamilies": [
        "rules"
      ]
    },
    "claude": {
      "meaning": "Generate Claude Code grounding files.",
      "outputFamilies": [
        "rules",
        "portable"
      ]
    },
    "codex": {
      "meaning": "Use AGENTS.md and the report index as the Codex grounding layer.",
      "outputFamilies": [
        "portable"
      ]
    },
    "orca": {
      "meaning": "Use AGENTS.md and the report index as the Orca/Grok grounding layer.",
      "outputFamilies": [
        "portable"
      ]
    }
  },
  "standardAnswerContract": [
    "Scope",
    "Evidence",
    "Diagnosis",
    "Fix Plan",
    "Run",
    "Verify",
    "Assumptions"
  ],
  "requiredReports": [
    {
      "path": ".workspai/reports/workspace-context-agent.json",
      "label": "Agent context pack",
      "required": true
    },
    {
      "path": ".workspai/reports/workspace-skills-index.json",
      "label": "Operational skills index",
      "required": true
    },
    {
      "path": ".workspai/reports/workspace-model.json",
      "label": "Workspace model graph",
      "required": false
    },
    {
      "path": ".workspai/reports/doctor-last-run.json",
      "label": "Workspace doctor",
      "required": false
    },
    {
      "path": ".workspai/reports/doctor-project-last-run.json",
      "label": "Project doctor",
      "required": false
    },
    {
      "path": ".workspai/reports/doctor-remediation-plan-last-run.json",
      "label": "Doctor remediation plan",
      "required": false
    },
    {
      "path": ".workspai/reports/artifact-remediation-plan-last-run.json",
      "label": "Artifact remediation plan",
      "required": false
    },
    {
      "path": ".workspai/reports/doctor-fix-result-last-run.json",
      "label": "Doctor fix result",
      "required": false
    },
    {
      "path": ".workspai/reports/analyze-last-run.json",
      "label": "Workspace analyze",
      "required": false
    },
    {
      "path": ".workspai/reports/pipeline-last-run.json",
      "label": "Governance pipeline",
      "required": false
    },
    {
      "path": ".workspai/reports/release-readiness-last-run.json",
      "label": "Release readiness",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-impact-last-run.json",
      "label": "Workspace impact",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-verify-last-run.json",
      "label": "Workspace verify",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-model-snapshot.json",
      "label": "Workspace model snapshot",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-model-diff-last-run.json",
      "label": "Workspace model diff",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-explain-last-run.json",
      "label": "Workspace explain",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-contract-verify-last-run.json",
      "label": "Workspace contract verify",
      "required": false
    },
    {
      "path": ".workspai/reports/workspace-intelligence-history.json",
      "label": "Workspace intelligence history",
      "required": false
    }
  ],
  "strictRules": [
    "Required reports must exist.",
    "Generated report paths must stay inside the workspace root.",
    "Generated customization text must be English-only.",
    "Agent answers must not claim pass, ready, or healthy without cited evidence.",
    "Commands must distinguish display guidance from execution requests.",
    "Agent hook files must be advisory and disabled by default unless the user explicitly enables them.",
    "MCP design artifacts must stay read-mostly until write tools have explicit approval boundaries."
  ],
  "outputKinds": [
    "report",
    "grounding",
    "instruction",
    "prompt",
    "skill",
    "skill-resource",
    "operational-skill",
    "skills-index",
    "explain-report",
    "agent",
    "rule",
    "hook",
    "mcp-design"
  ],
  "pathLayers": {
    "l1CanonicalRoots": [
      ".workspai/reports/",
      ".workspai/skills/"
    ],
    "l2PrefixedMirrorRoots": [
      ".github/",
      ".cursor/",
      ".claude/"
    ],
    "l3SharedIndustryFiles": [
      "AGENTS.md",
      ".github/copilot-instructions.md",
      "CLAUDE.md"
    ]
  }
}