credentials belong in environment variables or local secrets only, never in code or docs.
- Document prerequisites, expected cost, and runtime side effects.
- Prefer localhost-safe defaults and explicit
Never commit secrets, credentials, or raw sensitive payloads in logs or fixtures.
## Prose style
Documentation prose must be dense and technical. Do not use em dashes. Do not use colons
tests before handoff.
- Commit only the smallest durable tests for user-visible behavior, documented contracts,
persistence or migration, lifecycle or concurrency, recovery, security boundaries, or proven
regressions. Prefer
shapes or why a glob was split or broadened in the PR or maintenance
documentation.
Apply that precision to expensive or class-sharded selector-gated work. For
smaller unsharded jobs
Change Discipline
- Inspect the current implementation and its call sites before changing it. Design documents may lag behind the code after later refactoring and are not automatically authoritative.
- Preserve unrelated
Commit messages, PR titles, changelog entries, and release notes must be written in English.
- Documentation changes must update all existing language versions in sync, including repository README files
additions/removals/renames.
- `scripts/format_readmes.py` — Maintenance/normalization script.
## Architecture
The repo is structured as two parallel, mirrored documents that must stay in sync:
- `README.md` and `README-CN.md` share the same category structure, the same
errors
- Free tier: ~50 queries/day
- Wait until the next day or upgrade to Plus
## Documentation
### API Reference
**For detailed API documentation** (RPC IDs, parameter structures, response formats), see:
**[docs/API_REFERENCE.md](./docs/API_REFERENCE.md
friends) put build outputs **one
level up** from the git working tree. The Readme documents the recommended
clone-into-`src\` convention, which matches the layout that `gvfs clone`
creates
directly. Tests mirror the runtime tree inside `tests/` (`unit/`, `integration/`, and helper fixtures), and documentation resides in `docs/` plus localized READMEs.
## Build, Test, and Development Commands
- `pnpm install` — sync dependencies
Azure SDK for .NET - AI Agent Guidelines
This document provides guidelines for AI agents (e.g., GitHub Copilot, MCP-based assistants, LLM-based tools) working with the Azure
Claude Code Ultimate Guide - Project Context
## Purpose
This repository is the **comprehensive documentation for Claude Code** (Anthropic's CLI tool). It teaches users how to use Claude Code effectively through
hostnames, personal identities, infrastructure
details, and absolute user paths out of code, tests, fixtures,
documentation, commit messages, and pull request text. Run the private-data
scrub before publishing.
- Write changelog
macOS app, widgets, remote app, Swift Package modules, tests, OpenClaw integration, and project documentation.
## Workflow
For every task, follow these steps in order. Each phase is delegated to the named
Skills Generator
Generate [Agent Skills](https://agentskills.io/home) from project documentation.
PLEASE STRICTLY FOLLOW THE BEST PRACTICES FOR SKILL: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
- Focus on agents capabilities and practical usage patterns
upstream-compatible field has no local source yet, prefer omitting it or returning a documented empty value from the serializer rather than scattering optional fields in routes.
## Providers
- Provider code