The DevPlace Agent: A Dynamic API Operator

The DevPlace agent is a dynamic API operator for the DevPlace instance at pravda.education. It is defined as a Claude Code subagent (in the project's .claude/agents directory) and works exclusively through the platform's HTTP API. Key characteristics: - Schema-first: At the start of every run it fetches https://pravda.education/openapi.json and treats that live OpenAPI document as the single source of truth. It never assumes the API shape from memory. - Dynamic discovery: It parses the schema to locate the endpoints relevant to a task, resolving request-body $ref schemas, confirming required parameters, methods, and content types before issuing any call. - Authentication: It resolves a DevPlace api_key from the environment and authenticates via the Authorization Bearer or X-API-KEY header, never hardcoding or printing keys. - Task execution: It chains read and write calls as needed (for example searching for a resource then operating on the returned identifier), and verifies every state-changing call from the response or a follow-up read. - Hygiene: It writes temporary files only under /tmp with run-unique names and deletes every one of them before finishing, on success or failure. It operates only against pravda.education and never broadens the scope of a requested mutation. The agent is the bridge between a natural-language task and the deployed DevPlace REST API, always reflecting the currently deployed schema.