@appsforgood/next-supabase-kit 0.1.0

package/rosters/next-supabase-default-council.json

@@ -0,0 +1,228 @@
+{
+  "schemaVersion": 1,
+  "id": "next-supabase-default-council",
+  "stack": "next-supabase",
+  "required": true,
+  "defaultWorkflow": "planning",
+  "principle": "Planner routes work by default; Lead Architect convenes council for core changes before implementation.",
+  "agents": [
+    {
+      "id": "planner",
+      "name": "Planner",
+      "file": ".agent-kit/agents/planner.md",
+      "defaultFor": ["planning", "roadmap", "scope", "ambiguous-request", "handoff"],
+      "skills": ["planning-council", "best-practice-maturity-review", "agent-handoff-tracing", "docs-maintainer", "upgrade-maintenance"],
+      "handsOffTo": ["lead-architect", "frontend-design-lead", "qa-engineer", "docs-maintainer"]
+    },
+    {
+      "id": "lead-architect",
+      "name": "Lead Architect",
+      "file": ".agent-kit/agents/lead-architect.md",
+      "defaultFor": ["core-change", "architecture", "cross-layer-change", "technical-decision"],
+      "skills": [
+        "planning-council",
+        "best-practice-maturity-review",
+        "agent-handoff-tracing",
+        "nextjs-app-router",
+        "supabase-auth-rls",
+        "postgres-migrations",
+        "owasp-security-review",
+        "upgrade-maintenance"
+      ],
+      "handsOffTo": ["supabase-postgres-engineer", "nextjs-engineer", "security-reviewer", "qa-engineer", "docs-maintainer"]
+    },
+    {
+      "id": "supabase-postgres-engineer",
+      "name": "Supabase/Postgres Engineer",
+      "file": ".agent-kit/agents/supabase-postgres-engineer.md",
+      "defaultFor": ["schema", "migration", "rls", "auth", "storage", "sql"],
+      "skills": ["supabase-auth-rls", "postgres-migrations", "owasp-security-review"],
+      "handsOffTo": ["security-reviewer", "qa-engineer", "docs-maintainer", "deployment-observability-engineer"]
+    },
+    {
+      "id": "nextjs-engineer",
+      "name": "Next.js Engineer",
+      "file": ".agent-kit/agents/nextjs-engineer.md",
+      "defaultFor": ["app-router", "server-components", "route-handler", "server-action", "forms", "ui-state"],
+      "skills": ["nextjs-app-router", "content-first-design", "frontend-design-system", "accessibility-wcag", "testing-qa"],
+      "handsOffTo": ["frontend-design-lead", "security-reviewer", "qa-engineer", "docs-maintainer"]
+    },
+    {
+      "id": "frontend-design-lead",
+      "name": "Frontend Design Lead",
+      "file": ".agent-kit/agents/frontend-design-lead.md",
+      "defaultFor": [
+        "brand-content-intake",
+        "creative-direction",
+        "reference-led-critique",
+        "distinctiveness-benchmark",
+        "product-quality-scorecard",
+        "visual-design",
+        "component-system",
+        "visual-regression",
+        "accessibility",
+        "anti-generic-ui",
+        "screenshot-review"
+      ],
+      "skills": [
+        "content-first-design",
+        "reference-led-design-critique",
+        "frontend-distinctiveness-benchmark",
+        "frontend-product-quality-rubric",
+        "frontend-design-system",
+        "visual-regression-qa",
+        "accessibility-wcag"
+      ],
+      "handsOffTo": ["marketing-copy-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"]
+    },
+    {
+      "id": "marketing-copy-lead",
+      "name": "Marketing Copy Lead",
+      "file": ".agent-kit/agents/marketing-copy-lead.md",
+      "defaultFor": [
+        "copy",
+        "copywriting",
+        "marketing",
+        "positioning",
+        "messaging",
+        "value-proposition",
+        "landing-page-copy",
+        "headline",
+        "cta",
+        "conversion",
+        "onboarding-copy",
+        "empty-state-copy",
+        "voice-tone",
+        "pricing-copy"
+      ],
+      "skills": [
+        "positioning-messaging",
+        "conversion-copywriting",
+        "landing-page-copy",
+        "product-voice-tone",
+        "onboarding-empty-state-copy"
+      ],
+      "handsOffTo": ["frontend-design-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"]
+    },
+    {
+      "id": "security-reviewer",
+      "name": "Security Reviewer",
+      "file": ".agent-kit/agents/security-reviewer.md",
+      "defaultFor": ["security-review", "auth-boundary", "data-mutation", "external-call", "dependency", "secret"],
+      "skills": ["owasp-security-review", "supabase-auth-rls", "postgres-migrations"],
+      "handsOffTo": ["lead-architect", "qa-engineer", "docs-maintainer", "deployment-observability-engineer"]
+    },
+    {
+      "id": "qa-engineer",
+      "name": "QA Engineer",
+      "file": ".agent-kit/agents/qa-engineer.md",
+      "defaultFor": ["testing", "regression", "smoke", "acceptance-evidence"],
+      "skills": ["testing-qa", "best-practice-maturity-review", "visual-regression-qa", "accessibility-wcag"],
+      "handsOffTo": ["docs-maintainer", "deployment-observability-engineer"]
+    },
+    {
+      "id": "docs-maintainer",
+      "name": "Documentation Maintainer",
+      "file": ".agent-kit/agents/docs-maintainer.md",
+      "defaultFor": ["docs", "decisions", "spec", "style-guide", "roadmap", "upgrade-evidence"],
+      "skills": ["docs-maintainer", "planning-council", "best-practice-maturity-review", "agent-handoff-tracing", "upgrade-maintenance"],
+      "handsOffTo": ["deployment-observability-engineer"]
+    },
+    {
+      "id": "deployment-observability-engineer",
+      "name": "Deployment/Observability Engineer",
+      "file": ".agent-kit/agents/deployment-observability-engineer.md",
+      "defaultFor": ["release", "deployment", "environment", "logs", "rollback", "monitoring"],
+      "skills": ["deployment-observability", "testing-qa", "upgrade-maintenance"],
+      "handsOffTo": ["qa-engineer", "docs-maintainer"]
+    }
+  ],
+  "workflows": [
+    {
+      "id": "planning",
+      "triggers": ["plan", "roadmap", "phase", "scope", "what should we do", "break this down"],
+      "sequence": ["planner", "lead-architect", "qa-engineer", "docs-maintainer"],
+      "council": ["planner", "lead-architect"],
+      "requiredOutputs": ["phased checklist", "maturity target", "affected layers", "preserved capabilities", "verification plan", "docs impact"]
+    },
+    {
+      "id": "core-change",
+      "triggers": ["schema", "auth", "rls", "api", "route handler", "server action", "dependency", "upgrade", "release workflow", "package behavior", "cross-layer"],
+      "sequence": [
+        "planner",
+        "lead-architect",
+        "supabase-postgres-engineer",
+        "nextjs-engineer",
+        "security-reviewer",
+        "qa-engineer",
+        "docs-maintainer",
+        "deployment-observability-engineer"
+      ],
+      "council": ["lead-architect", "security-reviewer", "qa-engineer", "docs-maintainer"],
+      "requiredOutputs": [
+        "architecture decision",
+        "maturity evidence",
+        "security review",
+        "test evidence",
+        "doc updates",
+        "upgrade evidence when applicable",
+        "release or rollback notes"
+      ]
+    },
+    {
+      "id": "frontend-change",
+      "triggers": ["screen", "component", "layout", "design", "responsive", "accessibility", "screenshot"],
+      "sequence": ["planner", "frontend-design-lead", "marketing-copy-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"],
+      "council": ["frontend-design-lead", "marketing-copy-lead", "qa-engineer"],
+      "requiredOutputs": [
+        "brand/content intake",
+        "copy/value-proposition brief when public-facing or conversion-facing",
+        "creative-direction rationale",
+        "reference-set evidence",
+        "distinctiveness benchmark",
+        "design critique verdict",
+        "frontend product-quality scorecard",
+        "domain-specific UI rationale",
+        "visual QA evidence",
+        "state coverage",
+        "accessibility checks",
+        "desktop/mobile verification"
+      ]
+    },
+    {
+      "id": "marketing-copy",
+      "triggers": ["copy", "copywriting", "marketing", "positioning", "messaging", "value prop", "value proposition", "landing page", "headline", "cta", "conversion", "onboarding", "empty state", "pricing"],
+      "sequence": ["planner", "marketing-copy-lead", "frontend-design-lead", "qa-engineer", "docs-maintainer"],
+      "council": ["marketing-copy-lead", "frontend-design-lead"],
+      "requiredOutputs": [
+        "discovery questions answered or explicitly marked unknown",
+        "audience and segment assumptions",
+        "problem, pain, desired outcome, and value proposition",
+        "differentiators, proof points, objections, and counter-messaging",
+        "voice/tone guidance",
+        "page or flow copy inventory",
+        "CTA and conversion hypothesis",
+        "handoff notes for design and implementation"
+      ]
+    },
+    {
+      "id": "security-review",
+      "triggers": ["security", "owasp", "secret", "token", "permission", "ssrf", "idor", "dependency"],
+      "sequence": ["planner", "security-reviewer", "lead-architect", "qa-engineer", "docs-maintainer"],
+      "council": ["security-reviewer", "lead-architect"],
+      "requiredOutputs": ["finding severity", "attack path", "mitigation", "verification evidence"]
+    }
+  ],
+  "handoffRules": [
+    "Each agent must state its decision, risk, and required next handoff before passing work on.",
+    "Planner must classify meaningful work against QUALITY_GATES.md as baseline, strong, or best-practice before completion is claimed.",
+    "Meaningful multi-agent work must record council-session evidence in COUNCIL.md or a structured record that follows .agent-kit/schemas/council-session.schema.json.",
+    "Planner starts planning and ambiguous requests by default.",
+    "Lead Architect must review core changes before implementation.",
+    "Frontend Design Lead must record reference-set evidence, anti-references, a design critique verdict, a distinctiveness benchmark, and a frontend product-quality scorecard before accepting significant frontend work.",
+    "Marketing Copy Lead must ask discovery questions and record audience, pain, outcome, value proposition, proof, objections, voice/tone, and conversion goal before accepting public-facing or conversion-facing copy.",
+    "Security Reviewer must review auth, data mutation, external-call, dependency, secret, and release-risk changes.",
+    "QA Engineer must verify behavior changes before completion.",
+    "Documentation Maintainer must update living markdown when behavior, architecture, release, or standards change."
+  ]
+}

package/schemas/agent-roster.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/agent-roster.schema.json",
+  "title": "Agent Kit Agent Roster",
+  "type": "object",
+  "required": ["schemaVersion", "id", "stack", "required", "defaultWorkflow", "agents", "workflows", "handoffRules"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "stack": { "type": "string", "minLength": 1 },
+    "required": { "type": "boolean" },
+    "defaultWorkflow": { "type": "string", "minLength": 1 },
+    "principle": { "type": "string" },
+    "agents": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "skills"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "name": { "type": "string" },
+          "file": { "type": "string" },
+          "defaultFor": { "type": "array", "items": { "type": "string" } },
+          "skills": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+          "handsOffTo": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "workflows": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "sequence", "council", "requiredOutputs"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "triggers": { "type": "array", "items": { "type": "string" } },
+          "sequence": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+          "council": { "type": "array", "items": { "type": "string" } },
+          "requiredOutputs": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "handoffRules": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/audit-report.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/audit-report.schema.json",
+  "title": "Agent Kit Audit Report",
+  "type": "object",
+  "required": ["summary", "readiness", "findings"],
+  "additionalProperties": false,
+  "properties": {
+    "summary": {
+      "type": "object",
+      "required": ["pass", "warn", "fail"],
+      "additionalProperties": false,
+      "properties": {
+        "pass": { "type": "integer", "minimum": 0 },
+        "warn": { "type": "integer", "minimum": 0 },
+        "fail": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "readiness": {
+      "type": "object",
+      "required": ["level", "summary", "nextActions"],
+      "additionalProperties": false,
+      "properties": {
+        "level": {
+          "type": "string",
+          "enum": ["needs-setup", "baseline-setup", "needs-improvement", "best-practice-candidate"]
+        },
+        "summary": { "type": "string", "minLength": 1 },
+        "nextActions": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["level", "area", "message"],
+        "additionalProperties": false,
+        "properties": {
+          "level": { "type": "string", "enum": ["pass", "warn", "fail"] },
+          "area": { "type": "string", "minLength": 1 },
+          "message": { "type": "string", "minLength": 1 },
+          "remediation": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/correction-rules.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/correction-rules.schema.json",
+  "title": "Agent Kit Correction Rules",
+  "type": "object",
+  "required": ["schemaVersion", "rules"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "scope", "status", "text", "createdAt"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "scope": { "type": "string", "enum": ["session", "project", "agent", "upstream-proposal"] },
+          "status": { "type": "string", "enum": ["active", "retired", "proposed"] },
+          "text": { "type": "string", "minLength": 1 },
+          "appliesToAgents": { "type": "array", "items": { "type": "string" } },
+          "agentId": { "type": "string", "minLength": 1 },
+          "sourceSessionId": { "type": "string", "minLength": 1 },
+          "createdAt": { "type": "string", "format": "date-time" },
+          "reviewedAt": { "type": ["string", "null"], "format": "date-time" },
+          "retiredAt": { "type": "string", "format": "date-time" },
+          "reason": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/council-session.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/council-session.schema.json",
+  "title": "Agent Kit Council Session",
+  "type": "object",
+  "required": ["schemaVersion", "sessionId", "createdAt", "workflowId", "status", "request", "handoffs", "requiredOutputs", "verification"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "sessionId": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "workflowId": { "type": "string", "minLength": 1 },
+    "status": { "type": "string", "enum": ["planned", "in-progress", "blocked", "complete"] },
+    "request": { "type": "string", "minLength": 1 },
+    "affectedLayers": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "handoffs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["agentId", "decision", "risk", "nextHandoff"],
+        "additionalProperties": false,
+        "properties": {
+          "agentId": { "type": "string", "minLength": 1 },
+          "decision": { "type": "string", "minLength": 1 },
+          "risk": { "type": "string", "minLength": 1 },
+          "nextHandoff": { "type": "string", "minLength": 1 },
+          "evidence": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    "requiredOutputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "status"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "status": { "type": "string", "enum": ["missing", "partial", "complete", "not-applicable"] },
+          "evidence": { "type": "string" }
+        }
+      }
+    },
+    "verification": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["command", "result"],
+        "additionalProperties": false,
+        "properties": {
+          "command": { "type": "string", "minLength": 1 },
+          "result": { "type": "string", "enum": ["pass", "fail", "skipped"] },
+          "notes": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/model-routing.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/model-routing.schema.json",
+  "title": "Agent Kit Model Routing",
+  "type": "object",
+  "required": ["schemaVersion", "id", "stack", "reviewedAt", "reviewCadence", "principle", "profiles", "agentRoutes", "toolSurfaces", "updatePolicy"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "stack": { "type": "string", "minLength": 1 },
+    "reviewedAt": { "type": "string", "minLength": 1 },
+    "reviewCadence": { "type": "string", "minLength": 1 },
+    "principle": { "type": "string", "minLength": 1 },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "label", "intent", "reasoningEffort", "contextWindow", "latency", "cost", "preferredFor"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "label": { "type": "string", "minLength": 1 },
+          "intent": { "type": "string", "minLength": 1 },
+          "reasoningEffort": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
+          "contextWindow": { "type": "string", "enum": ["small", "medium", "large", "very-large", "varies"] },
+          "latency": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
+          "cost": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
+          "preferredFor": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+        }
+      }
+    },
+    "agentRoutes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["agentId", "profileId", "defaultEffort"],
+        "additionalProperties": false,
+        "properties": {
+          "agentId": { "type": "string", "minLength": 1 },
+          "profileId": { "type": "string", "minLength": 1 },
+          "defaultEffort": { "type": "string", "enum": ["low", "medium", "high"] },
+          "escalationProfileId": { "type": "string", "minLength": 1 },
+          "notes": { "type": "string" }
+        }
+      }
+    },
+    "toolSurfaces": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["tool", "instructionSurface", "modelSelection", "enforcement", "adapter"],
+        "additionalProperties": false,
+        "properties": {
+          "tool": { "type": "string", "minLength": 1 },
+          "instructionSurface": { "type": "string", "minLength": 1 },
+          "modelSelection": { "type": "string", "minLength": 1 },
+          "enforcement": { "type": "string", "enum": ["enforced", "partial", "advisory", "manual"] },
+          "adapter": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "updatePolicy": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/project-context.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/project-context.schema.json",
+  "title": "Agent Kit Project Context",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "projectName",
+    "productSummary",
+    "productCategory",
+    "primaryAudience",
+    "primaryWorkflows",
+    "businessCriticalBehavior",
+    "architecture",
+    "dataSensitivity",
+    "authModel",
+    "tenantModel",
+    "integrations",
+    "uiDirection",
+    "messaging",
+    "qualityTarget",
+    "knownConstraints",
+    "openQuestions",
+    "evidence",
+    "lastReviewedAt",
+    "owners"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "projectName": { "type": "string" },
+    "productSummary": { "type": "string" },
+    "productCategory": { "type": "string" },
+    "primaryAudience": { "type": "string" },
+    "primaryWorkflows": { "type": "array", "items": { "type": "string" } },
+    "businessCriticalBehavior": { "type": "array", "items": { "type": "string" } },
+    "architecture": {
+      "type": "object",
+      "required": ["scripts", "frameworks", "uiLibraries", "hasSupabase", "supabaseSignals", "testTools", "envExampleKeys", "deployment"],
+      "additionalProperties": false,
+      "properties": {
+        "packageManager": { "type": "string" },
+        "scripts": { "type": "array", "items": { "type": "string" } },
+        "frameworks": { "type": "array", "items": { "type": "string" } },
+        "uiLibraries": { "type": "array", "items": { "type": "string" } },
+        "hasSupabase": { "type": "boolean" },
+        "supabaseSignals": { "type": "array", "items": { "type": "string" } },
+        "testTools": { "type": "array", "items": { "type": "string" } },
+        "envExampleKeys": { "type": "array", "items": { "type": "string" } },
+        "deployment": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "dataSensitivity": { "type": "array", "items": { "type": "string" } },
+    "authModel": { "type": "string" },
+    "tenantModel": { "type": "string" },
+    "integrations": { "type": "array", "items": { "type": "string" } },
+    "uiDirection": {
+      "type": "object",
+      "required": ["preferred", "avoid"],
+      "additionalProperties": false,
+      "properties": {
+        "preferred": { "type": "string" },
+        "avoid": { "type": "string" }
+      }
+    },
+    "messaging": {
+      "type": "object",
+      "required": ["valueProposition", "proof", "objections"],
+      "additionalProperties": false,
+      "properties": {
+        "valueProposition": { "type": "string" },
+        "proof": { "type": "array", "items": { "type": "string" } },
+        "objections": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "qualityTarget": { "type": "string", "enum": ["baseline-setup", "needs-improvement", "best-practice-candidate"] },
+    "knownConstraints": { "type": "array", "items": { "type": "string" } },
+    "openQuestions": { "type": "array", "items": { "type": "string" } },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source", "note"],
+        "additionalProperties": false,
+        "properties": {
+          "source": { "type": "string", "minLength": 1 },
+          "note": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "lastReviewedAt": { "type": "string", "format": "date-time" },
+    "owners": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/session-event.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/session-event.schema.json",
+  "title": "Agent Kit Session Event",
+  "type": "object",
+  "required": ["type", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "session_started",
+        "project_context_loaded",
+        "agent_message",
+        "agent_decision",
+        "handoff",
+        "human_correction",
+        "correction_promoted",
+        "artifact_recorded",
+        "command_recorded",
+        "verification_recorded",
+        "open_question",
+        "required_output_updated",
+        "session_status_changed",
+        "session_rendered"
+      ]
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "agentId": { "type": "string", "minLength": 1 },
+    "fromAgentId": { "type": "string", "minLength": 1 },
+    "toAgentId": { "type": "string", "minLength": 1 },
+    "text": { "type": "string" },
+    "decision": { "type": "string" },
+    "risk": { "type": "string" },
+    "evidence": { "type": "array", "items": { "type": "string" } },
+    "scope": { "type": "string", "enum": ["session", "project", "agent", "upstream-proposal"] },
+    "correctionId": { "type": "string", "minLength": 1 },
+    "artifactPath": { "type": "string", "minLength": 1 },
+    "command": { "type": "string", "minLength": 1 },
+    "result": { "type": "string", "enum": ["pass", "fail", "skipped"] },
+    "outputName": { "type": "string", "minLength": 1 },
+    "outputStatus": { "type": "string", "enum": ["missing", "partial", "complete", "not-applicable"] },
+    "status": { "type": "string", "enum": ["planned", "in-progress", "blocked", "complete"] },
+    "notes": { "type": "string" }
+  }
+}