Update project from 'agents-common' Copier template (HEAD).

Author: emcd

.auxiliary/configuration/conventions.md .auxiliary/configuration/AGENTS.md.auxiliary/configuration/conventions.md renamed to .auxiliary/configuration/AGENTS.md

@@ -11,12 +11,41 @@
 - Check README files in directories you're working with for insights about architecture, constraints, and TODO items.
 - Update files under `.auxiliary/notes` during conversation, removing completed tasks and adding emergent items.
 
+<!-- OPENSPEC:START -->
+# OpenSpec Instructions
+
+These instructions are for AI assistants working in this project.
+
+Always open `@/openspec/AGENTS.md` when the request:
+- Mentions planning or proposals (words like proposal, spec, change, plan)
+- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
+- Sounds ambiguous and you need the authoritative spec before coding
+
+Use `@/openspec/AGENTS.md` to learn:
+- How to create and apply change proposals
+- Spec format and conventions
+- Project structure and guidelines
+
+Keep this managed block so 'openspec update' can refresh the instructions.
+
+<!-- OPENSPEC:END -->
+
+# Development Standards
+
+Before implementing code changes, consult these files in `.auxiliary/instructions/`:
+- `practices.rst` - General development principles (robustness, immutability, exception chaining)
+- `practices-python.rst` - Python-specific patterns (module organization, type annotations, wide parameter/narrow return)
+- `nomenclature.rst` - Naming conventions for variables, functions, classes, exceptions
+- `style.rst` - Code formatting standards (spacing, line length, documentation mood)
+- `validation.rst` - Quality assurance requirements (linters, type checkers, tests)
+
 # Operation
 
 - Use `rg --line-number --column` to get precise coordinates for MCP tools that require line/column positions.
 - Choose appropriate editing tools based on the task complexity and your familiarity with the tools.
-- Consider `mcp__pyright__edit_file` for more reliable line-based editing than context-based `Edit`/`MultiEdit` when making complex changes.
-- Use pyright MCP tools where appropriate: `rename_symbol` for refactors, `hover` for getting function definitions without searching through code, `references` for precise symbol analysis.
+- Use the 'pyright' MCP server where appropriate:
+    - `rename_symbol` for refactors
+    - `references` for precise symbol analysis
 - Batch related changes together when possible to maintain consistency.
 - Use relative paths rather than absolute paths when possible.
 - Do not write to paths outside the current project unless explicitly requested.
@@ -25,7 +54,7 @@
 # Commits
 
 - Use `git status` to ensure all relevant changes are in the changeset.
-- Do **not** commit without explicit user approval. Unless the user has requested the commit, ask for a review of your edits first.
+- Do **not** commit without explicit user approval. Unless the user has requested the commit, **ask first** for a review of your work.
 - Use present tense, imperative mood verbs (e.g., "Fix" not "Fixed").
 - Write sentences with proper punctuation.
 - Include a `Co-Authored-By:` field as the final line. Should include the model name and a no-reply address.

.auxiliary/configuration/coders/claude/miscellany/bash-tool-bypass

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""
+Command wrapper for Claude Code web environments.
+
+This script wraps command execution via Python subprocess to bypass
+Bash tool permission restrictions in Claude Code web environments.
+
+Usage:
+    bash-tool-bypass <command> [arguments...]
+
+Examples:
+    bash-tool-bypass gh --version
+    bash-tool-bypass gh pr view 1
+    bash-tool-bypass gh pr list --limit 5
+    bash-tool-bypass gh issue view 42 --json title,state,author
+    bash-tool-bypass gh repo view owner/repo
+    bash-tool-bypass some-other-restricted-command --flag value
+
+Notes:
+    - This wrapper is designed to bypass specific command restrictions in
+      Claude Code
+    - Common use case is running 'gh' commands when Bash tool blocks them
+      directly
+    - Any command accessible in PATH can be executed through this wrapper
+    - Authentication/permissions still apply to the wrapped command itself
+"""
+
+import subprocess
+import sys
+
+# Minimum required argument count (script name + command)
+MIN_ARGS = 2
+
+
+def main():
+    """Execute command via subprocess and exit with its return code."""
+    if len(sys.argv) < MIN_ARGS:
+        print(__doc__)
+        sys.exit(1)
+
+    # Build command with all arguments
+    cmd = sys.argv[1:]
+
+    # Execute command (intentionally passes through untrusted input)
+    result = subprocess.run(cmd, check=False)  # noqa: S603
+
+    # Exit with command's return code
+    sys.exit(result.returncode)
+
+
+if __name__ == '__main__':
+    main()

.auxiliary/configuration/coders/claude/miscellany/ccw-setup.md

@@ -0,0 +1,98 @@
+# Claude Code (Web) Session Setup
+
+**Instructions for Claude instances**: Execute the following setup steps at the beginning of each Claude Code (Web) session to ensure all required tools are available.
+
+## Required Setup Steps
+
+### 1. Install System Packages
+
+Install GitHub CLI from the latest release (ensures latest version instead of older Ubuntu package).
+
+First, get the latest version number:
+
+```bash
+wget https://github.com/cli/cli/releases/latest -O - 2>&1 | grep -oP 'href="/cli/cli/releases/tag/v\K[0-9.]+' | head -1
+```
+
+Then download and install, substituting the version number from above:
+
+```bash
+wget -O /tmp/gh_VERSION_linux_amd64.deb https://github.com/cli/cli/releases/download/vVERSION/gh_VERSION_linux_amd64.deb
+```
+
+```bash
+dpkg -i /tmp/gh_VERSION_linux_amd64.deb
+```
+
+### 2. Install Core Python Tools
+
+```bash
+uv tool install hatch
+uv tool install copier
+uv tool install emcd-agents
+```
+
+### 3. Populate Project Agents
+
+```bash
+agentsmgr populate project github:emcd/agents-common@master#defaults
+```
+
+### 4. Configure Environment
+
+Set up Go paths for persistent access. Append to `~/.local/bin/env`:
+
+```bash
+cat >> ~/.local/bin/env << 'EOF'
+
+# Add Go bin to PATH
+export GOPATH="${HOME}/.local/share/go"
+case ":${PATH}:" in
+    *:"${GOPATH}/bin":*)
+        ;;
+    *)
+        export PATH="${GOPATH}/bin:${PATH}"
+        ;;
+esac
+EOF
+```
+
+Source the updated environment:
+
+```bash
+source ~/.local/bin/env
+```
+
+### 5. Install Language Servers
+
+Install `mcp-language-server` (proxies language servers for MCP):
+
+```bash
+go install github.com/isaacphi/mcp-language-server@latest
+```
+
+Install Pyright (Python language server):
+
+```bash
+npm install -g pyright
+```
+
+Install Ruff (Python linter/formatter):
+
+```bash
+uv tool install ruff
+```
+
+### 6. Setup Bash Tool Bypass Wrapper
+
+Copy the bash-tool-bypass script to PATH for accessing restricted commands:
+
+```bash
+cp .auxiliary/configuration/coders/claude/miscellany/bash-tool-bypass ~/.local/bin/
+chmod +x ~/.local/bin/bash-tool-bypass
+```
+
+## Notes
+
+- The `.mcp.json` configuration expects these tools to be in PATH
+- The `bash-tool-bypass` wrapper enables execution of commands restricted by Claude Code Bash tool permissions

.auxiliary/configuration/coders/claude/settings.json

@@ -39,6 +39,18 @@
   },
   "permissions": {
     "auto_allow": [
+      "mcp__context7__get-library-docs",
+      "mcp__context7__resolve-library-id",
+      "mcp__librovore__query_content",
+      "mcp__librovore__query_inventory",
+      "mcp__pyright__definition",
+      "mcp__pyright__diagnostics",
+      "mcp__pyright__edit_file",
+      "mcp__pyright__hover",
+      "mcp__pyright__references",
+      "mcp__pyright__rename_symbol",
+      "Bash(hatch run *)",
+      "Bash(hatch --env develop run *)",
       "Bash(awk *)",
       "Bash(cat *)",
       "Bash(cut *)",
@@ -68,8 +80,6 @@
       "Bash(git show *)",
       "Bash(git status)",
       "Bash(grep *)",
-      "Bash(hatch run python *)",
-      "Bash(hatch --env develop run *)",
       "Bash(head *)",
       "Bash(ls *)",
       "Bash(ps *)",
@@ -80,15 +90,7 @@
       "Bash(tail *)",
       "Bash(uniq *)",
       "Bash(wc *)",
-      "Bash(which *)",
-      "mcp__context7__get-library-docs",
-      "mcp__context7__resolve-library-id",
-      "mcp__pyright__definition",
-      "mcp__pyright__diagnostics",
-      "mcp__pyright__edit_file",
-      "mcp__pyright__hover",
-      "mcp__pyright__references",
-      "mcp__pyright__rename_symbol"
+      "Bash(which *)"
     ]
   },
   "sandbox": {

.auxiliary/configuration/coders/gemini/miscellany/command-template.md

@@ -0,0 +1,43 @@
+
+# Process Title
+
+Brief introductory paragraph explaining the purpose.
+
+Target/input description: {{args}}
+
+## Context
+
+- Current state checks, if applicable: !{command1}
+- Environment info, if applicable: !{command2}
+- Relevant data, if applicable: !{command3}
+
+## Prerequisites
+
+Before running this process, ensure:
+- Prerequisite 1
+- Prerequisite 2
+- @-references to relevant guides if applicable
+
+## Process Summary
+
+Key functional areas:
+1. **Phase 1**: Description
+2. **Phase 2**: Description
+3. **Phase 3**: Description
+
+## Safety Requirements
+
+Stop and consult the user if:
+- List validation conditions
+- Error conditions that require user input
+- Unexpected situations
+
+## Execution
+
+Execute the following steps:
+
+### 1. Step Name
+Description of what this step does.
+
+### 2. Step Name
+More steps as needed.