AGENTS.md — PFPT Developer-Facing AI Agents Guide (net8.0 / SDK 8.0.120)

Use the following structured tools (function calls). Provide inputs, result logs, and exit codes in your output. <details> <summary>View Available Tool Schemas</summary> `json { "name": "run_command", "description": "Run a shell command in the repository root and capture stdout, stderr, and the exit code. Only dotnet commands are permitted.", "parameters": { "type": "object", "properties": { "cmd": { "type": "string", "description": "Command to execute" } }, "required": ["cmd"] } } ` `json { "name": "code_search", "description": "Search the repository text with ripgrep-like semantics.", "parameters": { "type": "object", "properties": { "query": { "type": "string" }, "path": { "type": "string", "description": "Optional file path or pattern to restrict the search." } }, "required": ["query"] } } ` `json { "name": "open_file", "description": "Open a file and return its content with line numbers.", "parameters": { "type": "object", "properties": { "path": { "type": "string" } }, "required": ["path"] } } ` `json { "name": "create_patch", "description": "Write a unified diff patch for a file. Fails if the expected_before_snippet does not match the current file content.", "parameters": { "type": "object", "properties": { "path": { "type": "string" }, "expected_before_snippet": { "type": "string", "description": "A small, unique snippet from the original file to ensure the patch is applied to the correct version." }, "after_content": { "type": "string", "description": "The full content of the file after the change." } }, "required": ["path", "after_content"] } } ` `json { "name": "create_file", "description": "Create a new file with the specified content.", "parameters": { "type": "object", "properties": { "path": { "type": "string", "description": "The full path where the new file should be created." }, "content": { "type": "string", "description": "The content to write to the new file." } }, "required": ["path", "content"] } } ` </details> When to use which: • code_search → locate symbols, TODOs, and API routes. • open_file → read before editing; include line refs in your plan. • create_file → add new files (tests, components, migrations). • run_command → run dotnet build/test, formatters, analyzers. • create_patch → apply single‑file diffs that keep the repo building. > Rationale: OpenAI function calling gives models safe capabilities with structured outputs. ⸻

> Treat this as the README for AI coding agents working on PFPT. It provides context, rules, and exact commands to make safe, useful changes. The goal is to match and complement our Copilot guidelines while being Codex‑native. Agents must read and adhere to this file before changing anything. ⸻

• Project: Physically Fit PT – Clinician Documentation App (PFPT) • Type: Hybrid .NET 8 MAUI + Blazor app; maximize shared code across platforms • Target frameworks: net8.0 • Required SDK: .NET SDK 8.0.120 • Architecture: Clean layering with shared RCL and service layers • HIPAA-conscious: Strict limits on PHI persistence, logging, and export flows (see Security)

` /src PhysicallyFitPT.Maui/ # MAUI shell (hybrid host) PhysicallyFitPT.Web/ # Blazor Web (WASM) surface PhysicallyFitPT.Api/ # Minimal/REST APIs PhysicallyFitPT.Core/ # Domain models, logic, interfaces, DTOs PhysicallyFitPT.Infrastructure/ # EF Core, services, integrations (QuestPDF, SkiaSharp, etc.) PhysicallyFitPT.Shared/ # Razor Class Library, shared UI, DTOs, clinical refs PhysicallyFitPT.AI/ # Agent integration & prompts (dev-facing) /tests/ PhysicallyFitPT.*.Tests/ # xUnit + FluentAssertions per layer ` > Keep this structure consistent with PFPT Copilot guidance. ⸻