agnostic-prompt-aps 1.1.1__py3-none-any.whl

aps_cli/payload/agnostic-prompt-standard/platforms/_schemas/platform-manifest.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agnostic-prompt-standard.dev/schemas/platform-manifest.schema.json",
+  "title": "APS Platform Adapter Manifest",
+  "type": "object",
+  "required": [
+    "platformId",
+    "displayName",
+    "adapterVersion",
+    "fileConventions"
+  ],
+  "properties": {
+    "platformId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "displayName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "adapterVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lastUpdated": {
+      "type": "string",
+      "minLength": 1
+    },
+    "docs": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "fileConventions": {
+      "type": "object",
+      "required": [
+        "skills",
+        "agents",
+        "prompts",
+        "instructions"
+      ],
+      "properties": {
+        "skills": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "agents": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "prompts": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "instructions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "frontmatter": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "toolNaming": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "notes": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

aps_cli/payload/agnostic-prompt-standard/platforms/_schemas/tools-registry.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agnostic-prompt-standard.dev/schemas/tools-registry.schema.json",
+  "title": "APS Platform Tool Registry",
+  "type": "object",
+  "required": [
+    "platformId",
+    "adapterVersion",
+    "tools"
+  ],
+  "properties": {
+    "platformId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "adapterVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lastUpdated": {
+      "type": "string",
+      "minLength": 1
+    },
+    "toolNaming": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "toolSets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "mention",
+          "description"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "mention": {
+            "type": "string"
+          },
+          "preferredName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "legacyName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "description": {
+            "type": "string"
+          },
+          "tools": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "mention",
+          "description",
+          "risk",
+          "sideEffects"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "mention": {
+            "type": "string"
+          },
+          "preferredName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "legacyName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "description": {
+            "type": "string"
+          },
+          "risk": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high"
+            ]
+          },
+          "sideEffects": {
+            "type": "string",
+            "enum": [
+              "none",
+              "reads",
+              "writes",
+              "executes",
+              "network",
+              "mixed"
+            ]
+          },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "notes": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "recommended": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

aps_cli/payload/agnostic-prompt-standard/platforms/_template/README.md

@@ -0,0 +1,10 @@
+# Platform Adapter Template
+
+Copy this folder to `platforms/<your-platform-id>/` and fill in:
+
+- `manifest.json`
+- `tools-registry.json`
+- `frontmatter/` templates
+- `templates/` ready-to-copy artifacts
+
+Then validate JSON against the schemas in `platforms/_schemas/`.

aps_cli/payload/agnostic-prompt-standard/platforms/_template/manifest.json

@@ -0,0 +1,25 @@
+{
+  "platformId": "your-platform-id",
+  "displayName": "Your Platform",
+  "adapterVersion": "0.1.0",
+  "lastUpdated": "YYYY-MM-DD",
+  "docs": {
+    "home": "https://example.com/docs"
+  },
+  "fileConventions": {
+    "skills": [
+      ".github/skills/<skill>/SKILL.md"
+    ],
+    "agents": [
+      ".github/agents/*.agent.md"
+    ],
+    "prompts": [
+      ".github/prompts/*.prompt.md"
+    ],
+    "instructions": [
+      ".github/copilot-instructions.md",
+      "AGENTS.md"
+    ]
+  },
+  "notes": "Describe platform-specific constraints here."
+}

aps_cli/payload/agnostic-prompt-standard/platforms/_template/tools-registry.json

@@ -0,0 +1,12 @@
+{
+  "platformId": "your-platform-id",
+  "adapterVersion": "0.1.0",
+  "lastUpdated": "YYYY-MM-DD",
+  "toolNaming": {
+    "mentions": "#tool",
+    "frontmatter": "tool-name"
+  },
+  "toolSets": [],
+  "tools": [],
+  "recommended": {}
+}

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/README.md

@@ -0,0 +1,100 @@
+# VS Code + GitHub Copilot adapter
+
+This adapter documents **how APS fits into VS Code Copilot's file conventions**, and provides ready-to-copy templates.
+
+## What this adapter provides
+
+- `manifest.json` — where VS Code discovers skills, agents, prompts, and instructions
+- `tools-registry.json` — a curated registry of tools/tool-sets and their **canonical frontmatter names**
+- `frontmatter/` — copy/paste YAML frontmatter templates for VS Code files
+- `templates/` — drop-in `.github/*` templates (agents)
+
+## Quickstart
+
+1. Install this APS skill into your repo at:
+   - `.github/skills/agnostic-prompt-standard/`
+2. Copy the templates into your workspace (root):
+   - From: `platforms/vscode-copilot/templates/.github/`
+   - To: `.github/`
+
+After copying, you'll have:
+- `.github/agents/aps-prompt-protocol.agent.md`
+
+## VS Code file locations (summary)
+
+VS Code Copilot discovers these files:
+
+- **Agent Skills**: `.github/skills/<skill-id>/SKILL.md`
+- **Custom agents**: `.github/agents/*.agent.md`
+- **Prompt files**: `.github/prompts/*.prompt.md`
+- **Custom instructions**:
+  - `.github/copilot-instructions.md`
+  - `.github/instructions/*.instructions.md`
+  - `AGENTS.md` (optional)
+
+See `manifest.json` for the full matrix (including personal and Claude locations).
+
+## Frontmatter nuances (important)
+
+VS Code uses **YAML frontmatter** in several file types.
+
+### `*.agent.md` (custom agents)
+
+Supported frontmatter keys include:
+
+- `name`
+- `description`
+- `argument-hint`
+- `tools`
+- `model`
+- `infer`
+- `target`
+- `handoffs`
+- `mcp-servers`
+
+**Lint note:** if you see diagnostics like "Unexpected indentation" on `description: >` blocks, keep `description` as a **single-line string** (quoted is safest).
+
+### `*.prompt.md` (prompt files)
+
+Common keys:
+
+- `name`
+- `description`
+- `argument-hint`
+- `agent` (ask|edit|agent|<custom-agent-id>)
+- `tools`
+- `model`
+
+See `frontmatter/` for templates.
+
+## Tools: names, tool-sets, and renames
+
+### Tool mentions vs `tools:`
+
+- In chat, tools appear as `#` mentions (ex: `#codebase`, `#problems`).
+- In frontmatter `tools: [...]`, list tool names **without** `#`.
+- Depending on VS Code version, some names are **qualified** (ex: `search/codebase`, `read/problems`, `web/fetch`).
+
+**Rule:** always prefer the exact tool name shown by VS Code's tools picker.
+
+### Common rename fixes (VS Code diagnostics)
+
+If you get diagnostics like "Tool or toolset X has been renamed", update frontmatter.
+Common mappings:
+
+- `problems` → `read/problems`
+- `changes` → `search/changes`
+- `usages` → `search/usages`
+- `fetch` → `web/fetch`
+- `todos` → `todo`
+
+This repository encodes the canonical names in `tools-registry.json`.
+
+### APS tool bundles
+
+For APS, we recommend starting with:
+
+- **Planner** (read-only-ish): `recommended.aps.planner`
+- **Implementer**: `recommended.aps.implementer`
+
+Both are defined in `tools-registry.json` so you can keep frontmatter small and consistent.

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/agent-frontmatter.md

@@ -0,0 +1,24 @@
+```yaml
+---
+name: Your Agent Name
+description: "What this agent does and when to use it."
+# Optional: a short hint shown in the UI
+argument-hint: "Describe the task…"
+# Optional: list of tools/tool-sets available to this agent
+tools: ["search", "read", "edit", "execute", "todo", "web/fetch"]
+# Optional: default model for this agent (if your org enables model selection)
+model: "GPT-4.1"
+# Optional: allow VS Code to run subagents (isolated contexts)
+infer: true
+# Optional: platform target (helps portability)
+target: vscode
+# Optional: tool servers + handoffs (advanced)
+mcp-servers: []
+handoffs: []
+---
+```
+
+Notes:
+- VS Code loads custom agents from `.github/agents/*.agent.md`.
+- If you see “Unexpected indentation” diagnostics, keep `description` as a **single-line** string (avoid YAML block scalars like `description: >`).
+- Tool names in `tools:` may be qualified (for example: `search/codebase`, `read/problems`, `web/fetch`). Prefer the exact tool name shown by VS Code’s tools picker.

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/instructions-frontmatter.md

@@ -0,0 +1,12 @@
+```yaml
+---
+applyTo: "**/*.ts,**/*.tsx"
+description: "Frontend coding conventions"
+# Optional (GitHub ecosystem): excludeAgent: "code-review" | "coding-agent"
+---
+```
+
+Notes:
+- VS Code supports a single `.github/copilot-instructions.md` (workspace-wide).
+- VS Code also supports targeted `*.instructions.md` files (default folder: `.github/instructions`).
+- VS Code can read `AGENTS.md` files (workspace root; optional nested via setting).

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/prompt-frontmatter.md

@@ -0,0 +1,18 @@
+```yaml
+---
+name: Your Prompt Name
+description: What this reusable prompt does.
+# Optional: short hint shown in the UI
+argument-hint: "Describe the input…"
+# Optional: default agent to run this prompt with (ask|edit|agent|<custom-agent-id>)
+agent: 'agent'
+# Optional: tools or tool sets for this prompt
+tools: ["search/codebase", "githubRepo", "web/fetch"]
+# Optional: default model
+model: "GPT-4.1"
+---
+```
+
+Notes:
+- VS Code loads prompt files from `.github/prompts/*.prompt.md`.
+- Tools list priority: prompt frontmatter > agent frontmatter > user selection (see VS Code docs).

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/skill-frontmatter.md

@@ -0,0 +1,10 @@
+```yaml
+---
+name: your-skill-name
+description: Description of what the skill does and when to use it.
+---
+```
+
+Notes:
+- `name` should be lowercase and hyphenated (e.g. `webapp-testing`).
+- Keep `description` specific so Copilot can auto-load the skill when relevant.

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/manifest.json

@@ -0,0 +1,40 @@
+{
+  "platformId": "vscode-copilot",
+  "displayName": "VS Code + GitHub Copilot",
+  "adapterVersion": "1.0.0",
+  "lastUpdated": "2026-01-15",
+  "docs": {
+    "agentSkills": "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
+    "promptFiles": "https://code.visualstudio.com/docs/copilot/customization/prompt-files",
+    "customAgents": "https://code.visualstudio.com/docs/copilot/customization/custom-agents",
+    "toolsInChat": "https://code.visualstudio.com/docs/copilot/chat/chat-tools",
+    "toolsReference": "https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features",
+    "customInstructions": "https://code.visualstudio.com/docs/copilot/customization/custom-instructions"
+  },
+  "fileConventions": {
+    "skills": [
+      ".github/skills/<skill-id>/SKILL.md",
+      "~/.copilot/skills/<skill-id>/SKILL.md",
+      ".claude/skills/<skill-id>/SKILL.md (legacy)",
+      "~/.claude/skills/<skill-id>/SKILL.md (legacy)"
+    ],
+    "agents": [
+      ".github/agents/*.agent.md"
+    ],
+    "prompts": [
+      ".github/prompts/*.prompt.md"
+    ],
+    "instructions": [
+      ".github/copilot-instructions.md",
+      ".github/instructions/*.instructions.md",
+      "AGENTS.md (root, optional nested via setting)",
+      "CLAUDE.md / GEMINI.md (GitHub ecosystem alternates)"
+    ]
+  },
+  "toolNaming": {
+    "chatMentions": "Tools are mentioned in chat with # (e.g. #codebase).",
+    "frontmatterTools": "Prompt/agent YAML frontmatter uses tool names (no leading #).",
+    "qualification": "Newer VS Code versions may require fully-qualified tool names (example: search/codebase). Always prefer the name displayed in the VS Code tools picker."
+  },
+  "notes": "This adapter documents VS Code Copilot-specific frontmatter and tool naming so APS prompts can be generated reproducibly."
+}

aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/templates/AGENTS.md

@@ -0,0 +1,7 @@
+# AGENTS.md (agent-wide workspace instructions)
+
+These instructions apply to AI agents working in this repository.
+
+- If you are generating prompts, follow APS v1.0 conventions.
+- Never modify files under `references/` unless explicitly asked to publish a spec revision.
+- Default to planning first; only apply edits after presenting a plan.