agnostic-prompt-aps 1.1.3__tar.gz → 1.1.5__tar.gz

agnostic_prompt_aps-1.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christopher Buckley, Juan Burckhardt, Anastasiya Smirnova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{agnostic_prompt_aps-1.1.3/src/agnostic_prompt_aps.egg-info → agnostic_prompt_aps-1.1.5}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: agnostic-prompt-aps
-Version: 1.1.3
+Version: 1.1.5
 Summary: CLI to install and manage the Agnostic Prompt Standard (APS) skill and platform templates.
 Author: Agnostic Prompt Standard contributors
-License: Apache-2.0
+License: MIT
 Project-URL: Homepage, https://github.com/chris-buckley/agnostic-prompt-standard
 Project-URL: Repository, https://github.com/chris-buckley/agnostic-prompt-standard.git
 Requires-Python: >=3.10
@@ -42,16 +42,47 @@ pipx run agnostic-prompt-aps init
 ## Commands
 
 ```bash
-aps init [--repo|--personal] [--platform <id>] [--templates] [--yes] [--force]
+aps init [--repo|--personal] [--platform <id>] [--yes] [--force]
 aps doctor [--json]
 aps platforms
 aps version
 ```
 
-## Claude platform path
+## Platform-specific paths
 
-If you need the Claude platform `.claude/skills` location, pass `--claude`:
+Use `--platform <id>` to specify a platform adapter:
 
 ```bash
-aps init --claude
+# VS Code / Copilot (default paths: .github/skills, ~/.copilot/skills)
+aps init --platform vscode-copilot
+
+# Claude Code (paths: .claude/skills, ~/.claude/skills)
+aps init --platform claude-code
 ```
+
+## Windows troubleshooting
+
+On Windows, `pipx run agnostic-prompt-aps` may fail with `FileNotFoundError` due to a known pipx bug with `.exe` launcher paths.
+
+**Workarounds:**
+
+1. **Use `pipx install` instead** (recommended):
+   ```bash
+   pipx install agnostic-prompt-aps
+   aps init
+   ```
+
+2. **Use Python module syntax**:
+   ```bash
+   python -m aps_cli init
+   ```
+
+3. **Try the full-name entry point**:
+   ```bash
+   pipx run agnostic-prompt-aps agnostic-prompt-aps init
+   ```
+
+4. **Upgrade pipx** to the latest version:
+   ```bash
+   python -m pip install --upgrade pipx
+   ```

agnostic_prompt_aps-1.1.5/README.md

@@ -0,0 +1,69 @@
+# APS CLI (Python)
+
+This package provides the `aps` CLI for installing the **Agnostic Prompt Standard (APS)** skill into:
+
+- a repository workspace: `.github/skills/agnostic-prompt-standard/`
+- or as a personal skill: `~/.copilot/skills/agnostic-prompt-standard/`
+
+## Install / run
+
+Global install (recommended):
+
+```bash
+pipx install agnostic-prompt-aps
+aps init
+```
+
+One-off run:
+
+```bash
+pipx run agnostic-prompt-aps init
+```
+
+## Commands
+
+```bash
+aps init [--repo|--personal] [--platform <id>] [--yes] [--force]
+aps doctor [--json]
+aps platforms
+aps version
+```
+
+## Platform-specific paths
+
+Use `--platform <id>` to specify a platform adapter:
+
+```bash
+# VS Code / Copilot (default paths: .github/skills, ~/.copilot/skills)
+aps init --platform vscode-copilot
+
+# Claude Code (paths: .claude/skills, ~/.claude/skills)
+aps init --platform claude-code
+```
+
+## Windows troubleshooting
+
+On Windows, `pipx run agnostic-prompt-aps` may fail with `FileNotFoundError` due to a known pipx bug with `.exe` launcher paths.
+
+**Workarounds:**
+
+1. **Use `pipx install` instead** (recommended):
+   ```bash
+   pipx install agnostic-prompt-aps
+   aps init
+   ```
+
+2. **Use Python module syntax**:
+   ```bash
+   python -m aps_cli init
+   ```
+
+3. **Try the full-name entry point**:
+   ```bash
+   pipx run agnostic-prompt-aps agnostic-prompt-aps init
+   ```
+
+4. **Upgrade pipx** to the latest version:
+   ```bash
+   python -m pip install --upgrade pipx
+   ```

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agnostic-prompt-aps"
-version = "1.1.3"
+version = "1.1.5"
 description = "CLI to install and manage the Agnostic Prompt Standard (APS) skill and platform templates."
 readme = "README.md"
 requires-python = ">=3.10"
-license = { text = "Apache-2.0" }
+license = { text = "MIT" }
 authors = [
   { name = "Agnostic Prompt Standard contributors" }
 ]
@@ -26,6 +26,7 @@ dev = [
 
 [project.scripts]
 aps = "aps_cli.cli:main"
+agnostic-prompt-aps = "aps_cli.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/chris-buckley/agnostic-prompt-standard"
@@ -41,3 +42,4 @@ aps_cli = ["payload/**"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+pythonpath = ["src"]

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5/src/agnostic_prompt_aps.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: agnostic-prompt-aps
-Version: 1.1.3
+Version: 1.1.5
 Summary: CLI to install and manage the Agnostic Prompt Standard (APS) skill and platform templates.
 Author: Agnostic Prompt Standard contributors
-License: Apache-2.0
+License: MIT
 Project-URL: Homepage, https://github.com/chris-buckley/agnostic-prompt-standard
 Project-URL: Repository, https://github.com/chris-buckley/agnostic-prompt-standard.git
 Requires-Python: >=3.10
@@ -42,16 +42,47 @@ pipx run agnostic-prompt-aps init
 ## Commands
 
 ```bash
-aps init [--repo|--personal] [--platform <id>] [--templates] [--yes] [--force]
+aps init [--repo|--personal] [--platform <id>] [--yes] [--force]
 aps doctor [--json]
 aps platforms
 aps version
 ```
 
-## Claude platform path
+## Platform-specific paths
 
-If you need the Claude platform `.claude/skills` location, pass `--claude`:
+Use `--platform <id>` to specify a platform adapter:
 
 ```bash
-aps init --claude
+# VS Code / Copilot (default paths: .github/skills, ~/.copilot/skills)
+aps init --platform vscode-copilot
+
+# Claude Code (paths: .claude/skills, ~/.claude/skills)
+aps init --platform claude-code
 ```
+
+## Windows troubleshooting
+
+On Windows, `pipx run agnostic-prompt-aps` may fail with `FileNotFoundError` due to a known pipx bug with `.exe` launcher paths.
+
+**Workarounds:**
+
+1. **Use `pipx install` instead** (recommended):
+   ```bash
+   pipx install agnostic-prompt-aps
+   aps init
+   ```
+
+2. **Use Python module syntax**:
+   ```bash
+   python -m aps_cli init
+   ```
+
+3. **Try the full-name entry point**:
+   ```bash
+   pipx run agnostic-prompt-aps agnostic-prompt-aps init
+   ```
+
+4. **Upgrade pipx** to the latest version:
+   ```bash
+   python -m pip install --upgrade pipx
+   ```

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/agnostic_prompt_aps.egg-info/SOURCES.txt

@@ -12,7 +12,6 @@ src/aps_cli/__main__.py
 src/aps_cli/cli.py
 src/aps_cli/core.py
 src/aps_cli/payload/agnostic-prompt-standard/SKILL.md
-src/aps_cli/payload/agnostic-prompt-standard/assets/agents/vscode-agent-v1.0.0.agent.md
 src/aps_cli/payload/agnostic-prompt-standard/assets/constants/constants-json-block-v1.0.0.example.md
 src/aps_cli/payload/agnostic-prompt-standard/assets/constants/constants-text-block-v1.0.0.example.md
 src/aps_cli/payload/agnostic-prompt-standard/assets/formats/format-code-changes-full-v1.0.0.example.md
@@ -28,6 +27,11 @@ src/aps_cli/payload/agnostic-prompt-standard/platforms/_schemas/tools-registry.s
 src/aps_cli/payload/agnostic-prompt-standard/platforms/_template/README.md
 src/aps_cli/payload/agnostic-prompt-standard/platforms/_template/manifest.json
 src/aps_cli/payload/agnostic-prompt-standard/platforms/_template/tools-registry.json
+src/aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/README.md
+src/aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/manifest.json
+src/aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/tools-registry.json
+src/aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/frontmatter/agent-frontmatter.md
+src/aps_cli/payload/agnostic-prompt-standard/platforms/claude-code/frontmatter/rules-frontmatter.md
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/README.md
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/manifest.json
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/tools-registry.json
@@ -35,7 +39,6 @@ src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatte
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/instructions-frontmatter.md
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/prompt-frontmatter.md
 src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/frontmatter/skill-frontmatter.md
-src/aps_cli/payload/agnostic-prompt-standard/platforms/vscode-copilot/templates/AGENTS.md
 src/aps_cli/payload/agnostic-prompt-standard/references/00-structure.md
 src/aps_cli/payload/agnostic-prompt-standard/references/01-vocabulary.md
 src/aps_cli/payload/agnostic-prompt-standard/references/02-linting-and-formatting.md

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/agnostic_prompt_aps.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+agnostic-prompt-aps = aps_cli.cli:main
 aps = aps_cli.cli:main

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "1.1.3"
+__version__ = "1.1.5"

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/cli.py

@@ -13,7 +13,7 @@ from . import __version__
 from .core import (
     SKILL_ID,
     copy_dir,
-    copy_templates,
+    copy_template_tree,
     default_personal_skill_path,
     default_project_skill_path,
     ensure_dir,
@@ -37,21 +37,22 @@ def _norm_platform(platform: Optional[str]) -> str:
     return platform
 
 
+def _is_claude_platform(platform_id: str) -> bool:
+    return platform_id == "claude-code"
+
+
 @app.command()
 def init(
     root: Optional[str] = typer.Option(
         None,
         "--root",
-        help="Workspace root to install templates / project skill under (defaults to repo root or cwd)",
+        help="Workspace root to install project skill under (defaults to repo root or cwd)",
     ),
     repo: bool = typer.Option(False, "--repo", help="Force install as project skill (workspace/.github/skills or workspace/.claude/skills)"),
     personal: bool = typer.Option(False, "--personal", help="Force install as personal skill (~/.copilot/skills or ~/.claude/skills)"),
     platform: Optional[str] = typer.Option(None, "--platform", help='Platform adapter to apply (default: inferred; use "none" for skill only)'),
-    templates: bool = typer.Option(False, "--templates", help="Also install platform templates (agents / AGENTS.md / .github/*), if available"),
-    templates_root: Optional[str] = typer.Option(None, "--templates-root", help="Workspace root for templates when installing personal skill"),
-    claude: bool = typer.Option(False, "--claude", help="Use Claude platform .claude/skills paths (instead of .github/skills + ~/.copilot/skills)"),
     yes: bool = typer.Option(False, "--yes", help="Non-interactive: accept inferred/default choices"),
-    force: bool = typer.Option(False, "--force", help="Overwrite existing skill/templates"),
+    force: bool = typer.Option(False, "--force", help="Overwrite existing skill"),
     dry_run: bool = typer.Option(False, "--dry-run", help="Print the plan only, do not write files"),
 ):
     """Install APS into a repo (.github/skills/...) or as a personal skill (~/.copilot/skills/...)."""
@@ -69,10 +70,6 @@ def init(
 
     install_scope = "repo" if repo else "personal" if personal else ("repo" if repo_root else "personal")
 
-    # Defaults
-    install_templates = templates or (platform_id not in ("", "none"))
-    chosen_templates_root: Optional[Path] = None
-
     if not yes and is_tty():
         # Platform selection (first, so platform choice can inform installation location)
         if not platform:
@@ -90,6 +87,7 @@ def init(
 
         # Scope
         if not (repo or personal):
+            claude = _is_claude_platform(platform_id)
             install_scope = questionary.select(
                 "Where should APS be installed?",
                 choices=[
@@ -106,59 +104,41 @@ def init(
             ).ask()
             assert isinstance(install_scope, str)
 
-        # Workspace root (only necessary for repo scope or for applying templates)
+        # Workspace root (only necessary for repo scope)
         if install_scope == "repo" and (not root and not repo_root):
             root_answer = questionary.text("Workspace root path:", default=str(workspace_root)).ask()
             workspace_root = Path(str(root_answer)).expanduser().resolve()
 
-        # Extras (templates)
-        install_templates = False
-        if platform_id != "none":
-            install_templates = questionary.confirm("Apply platform templates to the workspace?", default=True).ask()
-
         force = questionary.confirm("Overwrite existing files if they exist?", default=force).ask()
         dry_run = questionary.confirm("Dry run (print plan only)?", default=dry_run).ask()
 
-    # Determine where templates should be applied.
-    if install_templates and platform_id not in ("", "none"):
-        if install_scope == "repo":
-            chosen_templates_root = workspace_root
-        else:
-            if templates_root:
-                chosen_templates_root = Path(templates_root).expanduser().resolve()
-            elif repo_root:
-                chosen_templates_root = repo_root
-            else:
-                chosen_templates_root = Path.cwd().resolve()
-
     # Compute destinations
+    claude = _is_claude_platform(platform_id)
     skill_dest = (
         default_project_skill_path(workspace_root, claude=claude)
         if install_scope == "repo"
         else default_personal_skill_path(claude=claude)
     )
 
-    templates_src = (
-        payload_skill_dir / "platforms" / platform_id / "templates"
-        if platform_id not in ("", "none")
-        else None
-    )
+    # Determine template source if platform is set
+    templates_dir = None
+    template_root = None
+    if platform_id and platform_id != "none":
+        templates_dir = payload_skill_dir / "platforms" / platform_id / "templates"
+        if templates_dir.is_dir():
+            template_root = Path.home() if install_scope == "personal" else workspace_root
+        else:
+            templates_dir = None
 
     plan = {
         "install_scope": install_scope,
         "workspace_root": str(workspace_root),
-        "templates_root": str(chosen_templates_root) if chosen_templates_root else None,
         "platform_id": platform_id or None,
         "claude": bool(claude),
         "skill_source": str(payload_skill_dir),
         "skill_dest": str(skill_dest),
-        "install_templates": bool(
-            install_templates
-            and chosen_templates_root is not None
-            and templates_src is not None
-            and templates_src.is_dir()
-        ),
-        "templates_source": str(templates_src) if templates_src else None,
+        "templates_source": str(templates_dir) if templates_dir else None,
+        "templates_dest": str(template_root) if template_root else None,
         "force": bool(force),
     }
 
@@ -175,16 +155,27 @@ def init(
     ensure_dir(skill_dest.parent)
     copy_dir(payload_skill_dir, skill_dest)
 
-    templates_summary = None
-    if plan["install_templates"] and chosen_templates_root and templates_src and templates_src.is_dir():
-        templates_summary = copy_templates(templates_src, chosen_templates_root, force=force)
-
     console.print("[green]APS installed.[/green]")
     console.print(f"  Skill: {skill_dest}")
-    if templates_summary:
-        console.print(f"  Templates copied: {len(templates_summary['copied'])}")
-        if templates_summary["skipped"]:
-            console.print(f"  Templates skipped (existing): {len(templates_summary['skipped'])}")
+
+    # Copy templates (if platform has templates)
+    if templates_dir and template_root:
+        def filter_fn(rel_path: str) -> bool:
+            # Skip .github/** for personal installs (shouldn't put .github in home dir)
+            if install_scope == "personal" and rel_path.startswith(".github"):
+                return False
+            return True
+
+        copied = copy_template_tree(
+            templates_dir,
+            template_root,
+            force=force,
+            filter_fn=filter_fn,
+        )
+        if copied:
+            console.print(f"  Installed {len(copied)} template file(s):")
+            for f in copied:
+                console.print(f"    - {f}")
 
 
 @app.command()
@@ -227,16 +218,15 @@ def doctor(json_out: bool = typer.Option(False, "--json", help="Machine-readable
 def platforms():
     """List available platform adapters bundled with this APS release."""
     payload_skill_dir = resolve_payload_skill_dir()
-    platforms = load_platforms(payload_skill_dir)
+    plats = load_platforms(payload_skill_dir)
 
     table = Table(title="APS Platform Adapters")
     table.add_column("platform_id")
     table.add_column("display_name")
-    table.add_column("templates")
     table.add_column("adapter_version")
 
-    for p in platforms:
-        table.add_row(p.platform_id, p.display_name, "yes" if p.has_templates else "no", p.adapter_version or "")
+    for p in plats:
+        table.add_row(p.platform_id, p.display_name, p.adapter_version or "")
 
     console.print(table)
 

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/core.py

@@ -15,7 +15,6 @@ class Platform:
     platform_id: str
     display_name: str
     adapter_version: Optional[str]
-    has_templates: bool
 
 
 def is_tty() -> bool:
@@ -105,13 +104,11 @@ def load_platforms(skill_dir: Path) -> list[Platform]:
         platform_id = manifest.get("platformId", entry.name)
         display_name = manifest.get("displayName", entry.name)
         adapter_version = manifest.get("adapterVersion")
-        has_templates = (entry / "templates").is_dir()
         out.append(
             Platform(
                 platform_id=platform_id,
                 display_name=display_name,
                 adapter_version=adapter_version,
-                has_templates=has_templates,
             )
         )
     out.sort(key=lambda p: p.display_name.lower())
@@ -130,28 +127,38 @@ def copy_dir(src: Path, dst: Path) -> None:
     shutil.copytree(src, dst)
 
 
-def copy_templates(templates_dir: Path, workspace_root: Path, force: bool) -> dict[str, list[str]]:
-    """Merge-copy templates_dir into workspace_root.
+def copy_template_tree(
+    src_dir: Path,
+    dst_root: Path,
+    *,
+    force: bool = False,
+    filter_fn: Optional[callable] = None,
+) -> list[str]:
+    """Copy template files individually with optional filtering.
 
-    Returns {"copied": [...], "skipped": [...]}
+    Args:
+        src_dir: Source templates directory
+        dst_root: Destination root directory
+        force: Overwrite existing files
+        filter_fn: Callback (rel_path: str) -> bool; return False to skip
+
+    Returns:
+        List of relative paths that were copied
     """
     copied: list[str] = []
-    skipped: list[str] = []
-
-    for root, dirs, files in os.walk(templates_dir):
-        root_path = Path(root)
-        rel_root = root_path.relative_to(templates_dir)
-        for d in dirs:
-            ensure_dir(workspace_root / rel_root / d)
-        for f in files:
-            src = root_path / f
-            rel = (rel_root / f)
-            dst = workspace_root / rel
-            ensure_dir(dst.parent)
-            if dst.exists() and not force:
-                skipped.append(str(rel))
-                continue
-            shutil.copy2(src, dst)
-            copied.append(str(rel))
-
-    return {"copied": copied, "skipped": skipped}
+    for src_file in src_dir.rglob("*"):
+        if not src_file.is_file():
+            continue
+        rel_path = src_file.relative_to(src_dir)
+        rel_str = str(rel_path).replace("\\", "/")
+        if filter_fn and not filter_fn(rel_str):
+            continue
+        dst_file = dst_root / rel_path
+        if dst_file.exists() and not force:
+            continue
+        dst_file.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(src_file, dst_file)
+        copied.append(rel_str)
+    return copied
+
+

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/payload/agnostic-prompt-standard/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: agnostic-prompt-standard
 description: The reference framework to generate, compile, and lint greenfield prompts that conform to the Agnostic Prompt Standard (APS) v1.0.
-license: Apache-2.0
+license: MIT
 metadata:
   authors: "Christopher Buckley; Juan Burckhardt; Anastasiya Smirnova"
   spec_version: "1.0"
-  framework_revision: "1.1.3"
+  framework_revision: "1.1.5"
   last_updated: "2026-01-15"
 ---
 
@@ -55,7 +55,6 @@ This `SKILL.md` is the **entrypoint** for the Agnostic Prompt Standard (APS) v1.
     - `manifest.json` — file discovery rules.
     - `tools-registry.json` — tool names, sets, and renames.
     - `frontmatter/` — copy/paste YAML frontmatter templates.
-    - `templates/` — drop-in workspace artifacts (`AGENTS.md`, `.github/agents/`).
 - `scripts/` — optional build / compile / lint scripts (empty by default).
 
 ---

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/payload/agnostic-prompt-standard/assets/constants/constants-json-block-v1.0.0.example.md

@@ -6,10 +6,10 @@ DEFAULT_TZ: "Z"
 
 API_CONFIG: JSON<<
 {
-  "apiBasePath": "/v1",
-  "defaultTimeZone": DEFAULT_TZ,
+  "api_base_path": "/v1",
+  "default_time_zone": DEFAULT_TZ,
   "retries": 3,
-  "timeoutMs": 2000
+  "timeout_ms": 2000
 }
 >>
 </constants>

{agnostic_prompt_aps-1.1.3 → agnostic_prompt_aps-1.1.5}/src/aps_cli/payload/agnostic-prompt-standard/platforms/README.md

@@ -20,7 +20,6 @@ platforms/
     manifest.json                 # validates against _schemas/platform-manifest.schema.json
     tools-registry.json           # validates against _schemas/tools-registry.schema.json
     frontmatter/                  # copy/paste blocks for this platform
-    templates/                    # ready-to-copy workspace artifacts
 ```
 
 ## Add a new platform adapter
@@ -37,3 +36,10 @@ platforms/
 - Anything under `platforms/` is **non-normative** (documentation/templates/mappings only).
 - Adapters should prefer **mapping + configuration** over rewriting APS core rules.
 
+## Scope and Philosophy
+
+Adapters are intended to **map** the APS standard to a host platform. They are **not** project generators.
+We do not provide generic project scaffolding (like `settings.json` or root `CLAUDE.md` templates).
+
+> See [ADR 0001: Adapter Scope](https://github.com/chris-buckley/agnostic-prompt-standard/blob/main/docs/adr/0001-adapter-scope-no-scaffolding.md)
+