_product.json

{
  "priority": [
    "student learning workspace",
    "public campus info browser",
    "controlled REST / MCP surface",
    "admin maintenance surface"
  ],
  "surfaces": ["web", "rest", "mcp"],
  "roles": {
    "anon": "Unauthenticated visitor; can browse all public information.",
    "user": "Authenticated, non-suspended user; can manage personal state and perform social actions.",
    "admin": "Platform administrator; has governance, moderation, and maintenance capabilities.",
    "agent": "OAuth-authorized third-party client or MCP caller; inherits user permissions after authorization; does not inherit admin by default."
  },
  "terms": {
    "sectionSubscription": "In-app follow relationship; not equivalent to official course enrollment.",
    "homework": "Class-attached learning task; completion state is tracked per user independently.",
    "todo": "Personal user task; not attached to any class."
  },
  "workflow": [
    "Update the affected docs/features/<module>.json first whenever capabilities, tool surfaces, parameters, or outputs change.",
    "Use jq to inspect the affected module or metadata file while editing.",
    "Implement the behavior change in code.",
    "Check docs/features, AGENTS.md, and implementation for consistency before concluding."
  ],
  "display_conventions": {
    "real-models-only": "models mirrors prisma/schema.prisma model fields; API return DTO names stay in returns only.",
    "compact-surfaces": "surface status defaults to stable; use unavailable/planned/stable string shorthand when no page, route, tool, or group is listed.",
    "inherited-auth": "route and tool auth inherit capability auth unless explicitly overridden.",
    "compact-display": "display uses fields and filters only; keep field lists short and user-visible."
  }
}