Instruction file imported from BVSSHA-MSE/SSHA (.github/instructions/copilot/guidance-for-ai-agents.instructions.md). Copyright stays with the author.

Guidance for AI Agents

Name: Copilot Guidance for AI Agents
Author: BVSSHA-MSE

Honor GROUND_RULES.md: stay concise, honest, and proactive about risks or ambiguity.
Clarify requirements early: confirm language, target directories, and deliverables before generating code or content.
Keep notes in kb/: write concise, ASCII-only markdown, organized by topic; prefer incremental updates over long dumps.
Playground etiquette: keep experiments self-contained within their directory (asciidoctor_doc_system, clean_architecture_experiment); place specs in specs/ alongside code.
Prefer self-documenting code: use expressive names; reconsider the code expressiveness before adding comments.
Follow Conventional Commits 1.0.0 for all commits; align scopes with workspace areas (e.g., bvssh, docs, kb, playground, asciidoctor).
Update .github/copilot-instructions.md and related modules when new workflows or conventions emerge.

{ "ocm": "1", "id": "bvssha-mse-ssha-guidance-for-ai-agents-instructions", "kind": "skill", "name": "Copilot Guidance for AI Agents", "description": "Guidance and best practices for AI agents contributing to the SSHA workspace", "publisher": "BVSSHA-MSE", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Guidance and best practices for AI agents contributing to the SSHA workspace" ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/BVSSHA-MSE/SSHA", "path": ".github/instructions/copilot/guidance-for-ai-agents.instructions.md", "ref": "7121dca20803f49abe62802e56c1dc4ff0429243", "url": "https://github.com/BVSSHA-MSE/SSHA/blob/7121dca20803f49abe62802e56c1dc4ff0429243/.github/instructions/copilot/guidance-for-ai-agents.instructions.md", "key": "BVSSHA-MSE/SSHA/.github/instructions/copilot/guidance-for-ai-agents.instructions.md" }, "applies_to": "**" }, "instructions": "# Guidance for AI Agents\n\n- Honor [GROUND_RULES.md](../../../GROUND_RULES.md): stay concise, honest, and proactive about risks or ambiguity.\n- Clarify requirements early: confirm language, target directories, and deliverables before generating code or content.\n- Keep notes in kb/: write concise, ASCII-only markdown, organized by topic; prefer incremental updates over long dumps.\n- Playground etiquette: keep experiments self-contained within their directory (asciidoctor_doc_system, clean_architecture_experiment); place specs in specs/ alongside code.\n- Prefer self-documenting code: use expressi", "cost": { "context_tokens": 227 } }

Copilot Guidance for AI Agents

About

Guidance for AI Agents

Use it

Manifest

Reviews