Improve repository onboarding

Refresh the README, add focused usage/development/architecture/troubleshooting docs, add GitHub issue and PR templates, and track wiki source pages for the enabled repository wiki.

Co-Authored-By: OpenAI Codex <noreply@openai.com>

Author: xuio

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,61 @@
+name: Bug report
+description: Report a reproducible problem with the Claude Code Codex Subagents plugin.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a problem. Please avoid pasting secrets, auth logs, private prompts, or raw MCP traffic that contains sensitive project data.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened, and what did you expect instead?
+      placeholder: Claude called the plugin, but...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction steps
+      description: Include the smallest prompt/tool call that reproduces the issue.
+      placeholder: |
+        1. Start Claude Code with ...
+        2. Ask Claude ...
+        3. Observe ...
+    validations:
+      required: true
+  - type: input
+    id: plugin-version
+    attributes:
+      label: Plugin version or commit
+      placeholder: 0.1.1 or git SHA
+  - type: input
+    id: claude-version
+    attributes:
+      label: Claude Code version
+      placeholder: claude --version
+  - type: input
+    id: codex-version
+    attributes:
+      label: Codex version
+      placeholder: codex --version
+  - type: dropdown
+    id: path
+    attributes:
+      label: Execution path
+      options:
+        - ask_codex
+        - ask_codex_parallel
+        - persistent session
+        - async job
+        - app-server steering
+        - plugin install/loading
+        - other
+  - type: textarea
+    id: diagnostics
+    attributes:
+      label: Diagnostics
+      description: Paste sanitized `codex_status`, `codex_doctor`, or debug bundle excerpts. Redact private data.
+      render: text

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/xuio/claude-code-codex-subagents/security/advisories/new
+    about: Report private security issues through GitHub Security Advisories.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,38 @@
+name: Feature request
+description: Suggest an improvement to Codex delegation from Claude Code.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What workflow should become easier or more reliable?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: What should the plugin do?
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Claude tool selection
+        - Codex sessions
+        - Parallel agents
+        - Nested subagents
+        - Logging or diagnostics
+        - Installation
+        - Testing
+        - Documentation
+        - Other
+  - type: textarea
+    id: constraints
+    attributes:
+      label: Constraints
+      description: Security, compatibility, performance, or UX constraints to preserve.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Summary
+
+-
+
+## Validation
+
+- [ ] `npm run test:ci`
+- [ ] `npm run check:dist`
+- [ ] Real Claude/Codex validation, if the change affects live integration
+
+## Safety
+
+- [ ] Default behavior remains read-only unless this PR intentionally changes it
+- [ ] No credentials, private logs, local auth data, or machine-specific artifacts are committed
+- [ ] `dist/index.js` is rebuilt when TypeScript source changes

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+- Refreshed the README into a shorter onboarding page.
+- Added usage, architecture, development, and troubleshooting docs.
+- Added GitHub issue templates and a pull request template.
+
 ## 0.1.1
 
 - Compacted large MCP tool responses so successful long Codex runs do not surface as Claude Code tool-result overflow errors.

CONTRIBUTING.md

@@ -13,6 +13,8 @@ npm run test:ci
 
 `test:ci` is the portable suite used by GitHub Actions. It uses the fake Codex binary and does not require Claude Code, the Codex desktop app, or live credentials.
 
+See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for the full local setup, dev-link workflow, test tiers, and release checklist.
+
 Desktop-only and live-token checks are available when you need end-to-end validation:
 
 ```sh
@@ -27,3 +29,5 @@ npm run test:claude-real-codex
 - Prefer small, focused changes with tests that cover the MCP contract.
 - Do not commit credentials, local logs, generated temp files, or machine-specific paths.
 - Run `npm run build` before committing changes to `src/`, because the plugin manifest loads `dist/index.js`.
+- Run `npm run check:dist` before publishing changes that touch TypeScript source.
+- Update user-facing docs when tool names, defaults, safety behavior, or validation commands change.