ocserv/contrib/ai

AI Assistance Framework

This directory contains persona files for use with AI coding agents working on ocserv. See AGENTS.md in the repository root for the full agent guide.

Personas

File	Intended for
personas/ocserv-core-dev.md	Maintainers: bug investigation, code review, design, release
personas/ocserv-contributor.md	External contributors: features, bug fixes, security fixes
personas/ocserv-security-auditor.md	Security audits: vulnerability discovery, threat modeling, secure design review

Load the appropriate file as a system prompt prefix in your AI tool before starting work.

Requirements

The protocols/requirements-*.md files in this directory generate the structured requirements documents under doc/requirements/. When extending those documents, re-apply the same protocol that originally generated the target file (see the document map in doc/requirements/README.md) rather than hand-writing requirements in a different style.

Acknowledgment

The structure of this framework — composable persona and protocol files that can be combined into reliable, repeatable AI prompts — is inspired by PromptKit by Microsoft. The protocol names (anti-hallucination, memory-safety, security-vulnerability, self-verification) follow PromptKit's vocabulary. All content is written specifically for ocserv and its codebase.