Skip to content

AGENTS.md

Latest commit

 

History

History
80 lines (56 loc) · 4.22 KB

AGENTS.md

File metadata and controls

80 lines (56 loc) · 4.22 KB
Raw

hybridsolutionscloud.github.io — Agent instructions

What this repo is

Web application repo. Frontend built with TypeScript and React, following HCS development standards and platform conventions.

Start here — connect to the HCS Governance MCP

This repo is governed by the HCS Governance MCP server (connection details in .ai/mcp/mcp-servers.md). It is the source of truth for standards, hard rules, and orchestration guidance.

At session start, call:

bootstrap(repo="hybridsolutionscloud.github.io", client="<your client: claude-code | codex | gemini | cursor | vscode>")

It returns this repo's scope, the applicable hard rules, the index of applicable standards, the .ai/ session protocol, and orchestration guidance shaped for your client's capability tier. Prefer a live MCP answer over anything written in this file — this file is the offline fallback.

Offline fallback (when the MCP server is unreachable)

Standards scope: hcs

Hard rules digest:

  • No secrets, tokens, passwords, subscription/tenant/client IDs, or connection strings in any committed file.
  • All scripts: PowerShell 7+ — #Requires -Version 7.0, Set-StrictMode -Version Latest, $ErrorActionPreference = 'Stop'. Never PS 5.1, never Bash.
  • All documentation is Markdown only. Diagrams are draw.io only — commit the .drawio XML alongside any exported .png.
  • Commit format: type(scope): short description — types feat, fix, docs, chore, refactor, test — with an AB#<id> work-item reference.

Standards reference (public site — no auth required):

Session protocol

  1. Read .ai/state/ first — CURRENT_TASK.md, then HANDOFF.md, then OPEN_QUESTIONS.md.
  2. Then read .ai/memory/ for durable context (PROJECT_CONTEXT.md, DECISIONS.md, COMMANDS.md, GOTCHAS.md).
  3. Summarise your believed state back to the operator before making changes.
  4. Before ending the session, update .ai/state/HANDOFF.md — what changed, files touched, commands run and results, branch, blockers, next steps.

Full contract: the AI workspace standard.

Key facts

Fact Value
ADO org https://dev.azure.com/hybridcloudsolutions
ADO project N/A - see registry.yaml ado_project or ask the HCS Governance MCP get_repo for this repo's work-item tracking project
Area path N/A - see registry.yaml or ask the HCS Governance MCP
Key Vault kv-hcs-vault-01
Work item format AB#<id> in commits and PRs