chore(dx): improve onboarding flow and feedback templates

.github/DISCUSSION_TEMPLATE/first-run-report.md

@@ -0,0 +1,35 @@
+---
+title: "[First Run Report] "
+labels:
+  - onboarding
+  - first-run
+---
+
+## Outcome
+
+- Status: success / partial / blocked
+- Repository-scoped install used: yes/no
+
+## Commands you ran
+
+Paste the exact commands in order.
+
+## Expected vs actual
+
+- Expected:
+- Actual:
+
+## Errors (if any)
+
+Paste relevant error output snippets.
+
+## Environment details
+
+- OS:
+- Python version:
+- vstack version:
+- Copilot mode used: Agent / Ask / Edit
+
+## Follow-up
+
+What would have made this first run easier?

.github/DISCUSSION_TEMPLATE/model-cost-feedback.md

@@ -0,0 +1,27 @@
+---
+title: "[Model and Cost Feedback] "
+labels:
+  - models
+  - cost
+  - feedback
+---
+
+## Role and task
+
+Which role/task were you running (for example `@architect`, `/verify`, `/security`)?
+
+## Model used
+
+Which model did you use?
+
+## Quality and speed
+
+How would you rate output quality and response speed?
+
+## Cost-value tradeoff
+
+Did the selected model feel cost-effective for this task?
+
+## Preferred default
+
+Which default model would you prefer for this role/task and why?

.github/DISCUSSION_TEMPLATE/onboarding-feedback.md

@@ -0,0 +1,28 @@
+---
+title: "[Onboarding Feedback] "
+labels:
+  - onboarding
+  - feedback
+---
+
+## Context
+
+- First time using vstack: yes/no
+- Setup mode used: project (`--target`) / global (`--global`)
+- Environment: OS, Python version, editor version
+
+## What worked well
+
+Describe the parts of onboarding that felt clear and fast.
+
+## Where you got stuck
+
+List the exact step(s), commands, or docs that were unclear.
+
+## Time to first successful result
+
+How long did it take to run your first successful `@tester /verify` flow?
+
+## Suggested improvements
+
+If you could improve one thing for first-time users, what would it be?

.github/agents/architect.agent.md

@@ -18,9 +18,9 @@ tools:
 agents:
   - *
 model:
-  - Claude Opus 4.6 (copilot)
   - Claude Sonnet 4.6 (copilot)
   - GPT-5.3-Codex (copilot)
+  - Claude Opus 4.7 (copilot)
 user-invocable: true
 target: vscode
 handoffs:
@@ -120,4 +120,4 @@ Handoffs you own:
 - `@#analyse` — impact analysis, tradeoffs, feasibility
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"architect","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"architect","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/agents/designer.agent.md

@@ -131,4 +131,4 @@ Handoffs you own:
 - `@#openapi` — OpenAPI 3.1 spec writing and review
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"designer","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"designer","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/agents/engineer.agent.md

@@ -121,4 +121,4 @@ Only delegate when workstreams are genuinely independent.
 - `@#incident` — incident analysis and post-mortem writing
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"engineer","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"engineer","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/agents/product.agent.md

@@ -18,8 +18,8 @@ agents:
   - *
 model:
   - Claude Sonnet 4.6 (copilot)
-  - Claude Opus 4.6 (copilot)
   - GPT-5.3-Codex (copilot)
+  - Claude Opus 4.7 (copilot)
 user-invocable: true
 target: vscode
 handoffs:
@@ -122,4 +122,4 @@ Handoffs you own:
 - `@#onboard` — contributor onboarding guide generation
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"product","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"product","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/agents/release.agent.md

@@ -118,4 +118,4 @@ Handoffs you own:
 - `@#code-review` — final review before PR is opened
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"release","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"release","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/agents/tester.agent.md

@@ -126,4 +126,4 @@ Handoffs you own:
 - `@#incident` — incident analysis and post-mortem writing
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"tester","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"tester","artifact_type":"agent","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/instructions/git.instructions.md

@@ -41,4 +41,4 @@ Use these Git and release hygiene conventions in this project.
 1. Prefer local verification before pushing release-impacting changes.
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"git","artifact_type":"instruction","artifact_version":"0.1.0","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"git","artifact_type":"instruction","artifact_version":"0.1.0","generator":"vstack","vstack_version":"1.3.0"} -->

.github/instructions/python.instructions.md

@@ -42,4 +42,4 @@ Use these Python conventions in this project.
 1. Do not silence lint/type errors unless there is a documented, task-specific reason.
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"python","artifact_type":"instruction","artifact_version":"0.1.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"python","artifact_type":"instruction","artifact_version":"0.1.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/prompts/code-review.prompt.md

@@ -50,4 +50,4 @@ End with:
 - Biggest remaining risk: one sentence
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"code-review","artifact_type":"prompt","artifact_version":"0.1.0","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"code-review","artifact_type":"prompt","artifact_version":"0.1.0","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/adr/SKILL.md

@@ -199,4 +199,4 @@ After writing, state the file path and summary so the architect or product role
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"adr","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"adr","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/analyse/SKILL.md

@@ -227,4 +227,4 @@ ______________________________________________________________________
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"analyse","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"analyse","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/architecture/SKILL.md

@@ -280,4 +280,4 @@ For each significant structural decision made during this review (technology cho
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"architecture","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"architecture","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/cicd/SKILL.md

@@ -201,4 +201,4 @@ ______________________________________________________________________
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"cicd","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"cicd","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/code-review/SKILL.md

@@ -219,4 +219,4 @@ Confidence: [HIGH/MEDIUM/LOW — explain if not HIGH]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"code-review","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"code-review","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/concise/SKILL.md

@@ -160,4 +160,4 @@ ______________________________________________________________________
 - [ ] User confirmation/status returned in deterministic format
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"concise","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"concise","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/consult/SKILL.md

@@ -227,4 +227,4 @@ reason: [one sentence]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"consult","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"consult","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/container/SKILL.md

@@ -154,4 +154,4 @@ ______________________________________________________________________
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"container","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"container","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/debug/SKILL.md

@@ -279,4 +279,4 @@ Prevention: [any follow-up items]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"debug","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"debug","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/dependency/SKILL.md

@@ -325,4 +325,4 @@ Action items (priority order):
 ```
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"dependency","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"dependency","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/design/SKILL.md

@@ -263,4 +263,4 @@ Output a complete design document to `docs/design/design.md` or `openapi.yaml`:
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"design","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"design","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/docs/SKILL.md

@@ -167,4 +167,4 @@ Skipped (n/a):
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"docs","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"docs","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/explore/SKILL.md

@@ -241,4 +241,4 @@ Stack:   [language, framework, runtime versions]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"explore","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"explore","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/guardrails/SKILL.md

@@ -77,4 +77,4 @@ Explicitly ask to "disable guardrails".
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"guardrails","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"guardrails","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/incident/SKILL.md

@@ -325,4 +325,4 @@ Status:               [Draft — ready for team review]
 ```
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"incident","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"incident","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/inspect/SKILL.md

@@ -165,4 +165,4 @@ ______________________________________________________________________
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"inspect","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"inspect","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/migrate/SKILL.md

@@ -337,4 +337,4 @@ Pre-deploy checklist:
 ```
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"migrate","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"migrate","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/onboard/SKILL.md

@@ -321,4 +321,4 @@ Gaps remaining (if any):
 ```
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"onboard","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"onboard","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/openapi/SKILL.md

@@ -414,4 +414,4 @@ Summary: [N critical, N warnings, N info]
 `$ref` for all reusable schemas, and validate it passes linting.
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"openapi","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"openapi","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/performance/SKILL.md

@@ -258,4 +258,4 @@ ______________________________________________________________________
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"performance","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"performance","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/pr/SKILL.md

@@ -140,4 +140,4 @@ CI/CD will now:
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"pr","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"pr","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/refactor/SKILL.md

@@ -385,4 +385,4 @@ Behavior changed:   No
 ```
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"refactor","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"refactor","artifact_type":"skill","artifact_version":"1.0.1","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/release-notes/SKILL.md

@@ -159,4 +159,4 @@ Keep existing entries intact.
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"release-notes","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"release-notes","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/requirements/SKILL.md

@@ -219,4 +219,4 @@ After writing, summarize what was decided so the architect role can start.
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"requirements","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"requirements","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/security/SKILL.md

@@ -295,4 +295,4 @@ Scope: [full/diff/dependency/config]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"security","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"security","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->

.github/skills/verify/SKILL.md

@@ -282,4 +282,4 @@ scope: [path/component/full]
 ______________________________________________________________________
 
 <!-- AUTO-GENERATED — maintained by vstack, do not edit directly -->
-<!-- VSTACK-META: {"artifact_name":"verify","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"0.0.0.post3.dev0+df3fe6e"} -->
+<!-- VSTACK-META: {"artifact_name":"verify","artifact_type":"skill","artifact_version":"1.0.2","generator":"vstack","vstack_version":"1.3.0"} -->