This is an M365 Copilot declarative agent project managed by the ATK CLI. When working on this project, you MUST use the appropriate skill for the task. Do NOT work directly on files without invoking a skill first. This is a declarative agent project. For ANY task in this workspace — regardless of what it is — you MUST invoke the declarative-agent-developer skill BEFORE doing any work. This is not optional. Do not attempt to handle any task yourself. Always…
This repository uses Spec-Driven Development for project development. Root SPEC.md and relevant module SPEC.md files are the grounding truth for project code and project logic. They do not define the SDD workflow. This file and .github/skills/ control agent write authorization and SDD phase transitions. Project SPEC.md files must not duplicate or override those workflow rules. Ordinary discussion, explanation, review, and planning are read-only. Do not automatically load or invoke repository workflow skills. Before creating, modifying, renaming, or deleting project development…
This file defines repository-level guidance for coding agents and contributors. This repo is a beginner workshop for Microsoft Foundry hosted agents with .NET 10. Primary learning flow: When UI images need refresh for docs: Expected outputs: Before publishing updates:
PowerShell module and tooling to migrate third-party SSE/ZTNA configurations to Microsoft Entra Global Secure Access (Private Access / Internet Access). This file is the entry point for humans and coding agents. verify.ps1 validates the module manifest (Test-ModuleManifest), imports the module, and runs Pester tests if present. A change is done when verify.ps1 passes, the pre-commit hook (.githooks/pre-commit.ps1) is satisfied, and docs are updated for user-facing changes.
amplifierappcli/data/ ships inside the CLI's own wheel — anything placed there loads for every user, every session, version-locked to the installed CLI, with no bundle composition step in between. That reach is exactly why it must stay small. Before adding anything here, run it through these three tests, in order: 1. Does it depend on something the CLI uniquely provides, that cannot move? A slash command, a settings key, a terminal affordance — something with no home outside this process.…
This file provides context and guidelines for AI agents (GitHub Copilot, Claude, etc.) working on this codebase. Two surfaces, two homes. docs/ is the design spec for the website-as-product (what we teach, how content is structured, principles). .github/ is the build harness (instructions, prompt files, skills, custom agents, hooks) for editing the website. Start with docs/README.md and docs/harness.md. AI-Native Development Tutorial Website - An interactive tutorial teaching anyone how to accelerate their workflow using AI-Native development techniques. Teach developers —…
Guidance for AI coding agents working in this repository (the Azure SQL Database container Private Preview). If you instead want your own agent to run and build against the container in your project, install the skill: npx skills add microsoft/azure-sql-database-container. This file is about contributing to the repo, not about using the container. The Azure SQL Database container is the Azure SQL Database engine, running locally for development and CI. It is wire-compatible with Azure SQL Database in the Microsoft…
Code in this repository should follow the guidelines specified in the Microsoft Rust Guidelines. The spell checker dictionary is in the .spelling file, one word per line in arbitrary order. Do not manually edit CHANGELOG.md files. Changelogs are automatically updated on release. Each crate's design is captured under crates/<crate>/docs/, kept in lockstep with the code (as pioneered by cargo-anvil and cargo-coverage-gate). Design is the contract; code is the realization. This is prospective, not a retroactive invariant: new crates land with…
This directory holds the install-ms-cli, ms-app-pack, and ms-app-deploy GitHub Actions for building and deploying Microsoft Managed Apps from CI. If you're an agent (GitHub Copilot CLI, Claude Code, or any other) helping with this component, the reusable skills below are plain Markdown runbooks — read the relevant one and follow its steps. - Build the actions: cd github-actions && npm install && npm run build (compiles src/ and bundles each action into dist/actions/<name>/index.js). - dist/ is committed and referenced by…
Read this first. It is the onboarding contract for any agent/session working in vsce-testing. It encodes the validated way to drive the WinApp VS Code extension (microsoft-winappcli.winapp) inside a live VS Code instance, plus every gotcha that has already cost hours to rediscover. Follow the "Getting started" checklist before doing anything else. This directory lives inside the WinAppVSCE repo at .github/skills/vsce-testing/. It provides the infrastructure for an agent to launch an isolated VS Code instance with the WinApp extension installed…
Canonical contributor and AI-agent guidance. Durable architecture and runbooks live in docs/. Before changing authentication, deployment, or authorization code, read: Common flows: Use python3 scripts/test_agents.py to validate the live enforcement matrix after deployment.
All Azure infrastructure-as-code for the Identity Research for Agent Management Using SPIFFE. Deployed via azd provision (Step 1 of deploy.sh). Never edit Container App container specs in Bicep — deploy.sh manages the full container configuration to avoid the multi-container reset bug (Learning #3).
README for AI coding agents. If you're a human looking for setup or usage instructions, read README.md instead. This file is the dedicated place where Claude Code, Copilot CLI, Codex, Cursor, Jules, Amp, and friends find the context they need to be productive on this repo without re-deriving it from grep. Format: agents.md — used by 60k+ open-source projects and stewarded by the Agentic AI Foundation under the Linux Foundation. The closest AGENTS.md to the file you're editing wins; explicit…
PowerShell-based Intune tenant configuration exporter. The repo contains a single read-only script that connects to Microsoft Graph and generates Markdown documentation for an Intune tenant: per-platform files, a combined full-tenant…
The project uses uv for dependency management with pyproject.toml at the repo root. Python ≥3.11 is required. Always run commands from the repo root. Use uv run to run any script (e.g. uv run python src/script.py) and uv add to add packages. The virtual environment is managed automatically — do not manually activate .venv. src/ is on the Python path. All imports use the agora_workbench namespace: Do not use bare package names — from code_execution import ... is wrong. BaseMCPServer…
Inspired by microsoft/agent-framework/python/AGENTS.md. Read this before you write any code in this repo — whether you are a human, GitHub Copilot, or the Copilot Coding Agent. This repository implements ZavaShop, a multi-agent retail supply-chain demo. It runs on AKS (long-lived orchestrator) and Azure Container Apps (event-driven specialist agents). Agents are built with Microsoft Agent Framework (MAF) and the GitHub Copilot SDK Python provider. Treat every change as production-style: typed, tested, observable. This repo is delivered through GitHub Copilot Custom Agents.…
Notes for AI agents and humans working on this repo. For what the repo produces, see README.md. For the integration architecture across all downstream surfaces (layer stack, publish points, version numbers, and the change-to-release impact matrix), see docs/LAYERSANDRELEASES.md. It is the single source of truth for "if I change X, what needs to be released." This is a multi-artifact monorepo: one Python engine + CLI, one TypeScript wrapper SDK, one Python wrapper SDK. Each is independently versioned, with its own…
MicrosoftAGENTS.md