chore(dx): improve onboarding flow and feedback templates

[eschaar]

Summary

DX, onboarding, and PyPI publishing release.

• Improved README onboarding flow: team setup guidance, expected output examples, troubleshooting flowchart, quick navigation, pipx rationale, and GitHub install alternative
• Added GitHub Discussion templates: onboarding-feedback, first-run-report, model-cost-feedback
• Added PyPI publish job to release workflow using OIDC trusted publishing (no API tokens)
• Added PyPI badge and updated install instructions in README to pipx install vstack
• Updated architect and product agent model list (Opus 4.7)
• Fixed test test_install_and_verify_exits_zero writing to repo root instead of tmp_path
• Simplified release workflow job names: release, build, publish
• Fixed build job missing fetch-depth: 0 (needed for poetry-dynamic-versioning)
• Fixed download-artifact@v5 / upload-artifact@v7 version mismatch → both now v7

Related Issues

N/A

Validation

• Tests pass locally
• CI checks pass
• Docs updated (if needed)

Release Impact

• fix: (patch) — bug fixes in test isolation and workflow
• feat: (minor) — PyPI publishing, DX improvements

[Copilot]

Pull request overview

This PR improves onboarding/developer experience by expanding README guidance (quick paths, validation expectations, troubleshooting), adding GitHub Discussion templates for feedback collection, and aligning agent template metadata/model lists with regenerated .github/ artifacts.

Changes:

• Updated agent templates/tests to reflect the current model fallback list (including Claude Opus 4.7).
• Expanded and reorganized README.md for first-run onboarding (quick paths, quick check, troubleshooting, CLI command index).
• Added changelog entries for recent releases and added new GitHub Discussion templates; regenerated installed artifacts/metadata.

Reviewed changes

Copilot reviewed 46 out of 46 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/vstack/agents/test_generation.py	Updates expected generated agent frontmatter model list.
src/vstack/_templates/agents/product/config.yaml	Updates product agent model fallback list (Opus 4.7) in template source.
src/vstack/_templates/agents/architect/config.yaml	Updates architect agent model fallback list (Opus 4.7) in template source.
docs/architecture/adr/001-vscode-native-variant.md	Broadens model guidance wording (4.6+).
README.md	Major onboarding/quickstart/troubleshooting restructuring and expanded guidance.
CHANGELOG.md	Adds missing recent versions and introduces a 1.2.6 entry.
.github/vstack.json	Updates installed manifest metadata (version/timestamp).
.github/skills/vision/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/verify/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/security/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/requirements/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/release-notes/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/refactor/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/pr/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/performance/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/openapi/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/onboard/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/migrate/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/inspect/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/incident/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/guardrails/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/explore/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/docs/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/design/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/dependency/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/debug/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/container/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/consult/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/concise/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/code-review/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/cicd/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/architecture/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/analyse/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/skills/adr/SKILL.md	Regenerated skill footer metadata (VSTACK-META vstack_version).
.github/prompts/code-review.prompt.md	Regenerated prompt footer metadata (VSTACK-META vstack_version).
.github/instructions/python.instructions.md	Regenerated instruction footer metadata (VSTACK-META vstack_version).
.github/instructions/git.instructions.md	Regenerated instruction footer metadata (VSTACK-META vstack_version).
.github/agents/tester.agent.md	Regenerated agent footer metadata (VSTACK-META vstack_version).
.github/agents/release.agent.md	Regenerated agent footer metadata (VSTACK-META vstack_version).
.github/agents/product.agent.md	Regenerated agent metadata/footer and model list (Opus 4.7).
.github/agents/engineer.agent.md	Regenerated agent footer metadata (VSTACK-META vstack_version).
.github/agents/designer.agent.md	Regenerated agent footer metadata (VSTACK-META vstack_version).
.github/agents/architect.agent.md	Regenerated agent metadata/footer and model list (Opus 4.7).
.github/DISCUSSION_TEMPLATE/onboarding-feedback.md	Adds onboarding feedback discussion template.
.github/DISCUSSION_TEMPLATE/model-cost-feedback.md	Adds model/cost feedback discussion template.
.github/DISCUSSION_TEMPLATE/first-run-report.md	Adds first-run report discussion template.