Skip to content

feat: improve onboarding first-run workflow#2

Open
airmang wants to merge 2 commits into
mainfrom
feat/onboarding-first-run
Open

feat: improve onboarding first-run workflow#2
airmang wants to merge 2 commits into
mainfrom
feat/onboarding-first-run

Conversation

@airmang
Copy link
Copy Markdown
Owner

@airmang airmang commented Apr 18, 2026

Summary

  • reposition the README around beginner onboarding and first-success workflows
  • add scripts/quickcheck.py for an end-to-end environment and example sanity check
  • make install and validation guidance clearer for users who only install the skill

Testing

  • created a temporary Python 3.11 venv
  • installed lxml and local python-hwpx into the venv
  • ran python scripts/quickcheck.py successfully inside that venv

@airmang
Copy link
Copy Markdown
Owner Author

airmang commented May 6, 2026

Codex update: pushed 6f5c477 to this existing branch with the proposal preset workflow docs/example/quickcheck path.

Added in this update:

  • examples/04_create_proposal.py
  • scripts/quickcheck.py --proposal
  • README/SKILL/API notes for sample_match and visual_review_required

Validation:

  • PYTHONPATH=/Users/wilycastle/Code/projects/python-hwpx/src /Users/wilycastle/Code/projects/python-hwpx/.venv/bin/python scripts/quickcheck.py --proposal → passed

airmang and others added 2 commits May 6, 2026 23:40
Add the proposal-generation example and quickcheck path so agents can generate and inspect sample-matched HWPX proposals through python-hwpx.

Constraint: skill must orchestrate python-hwpx behavior instead of duplicating low-level HWPX logic.
Rejected: hiding visual limitations | reports keep visual_review_required for proxy-only quality checks.
Confidence: high
Scope-risk: narrow
Directive: Treat sample_match.pass as a proxy-quality gate, not as rendered visual parity.
Tested: PYTHONPATH=/Users/wilycastle/Code/projects/python-hwpx/src /Users/wilycastle/Code/projects/python-hwpx/.venv/bin/python scripts/quickcheck.py --proposal -> passed
Not-tested: packaged skill install outside this checkout
Co-authored-by: OmX <omx@oh-my-codex.dev>
@airmang airmang force-pushed the feat/onboarding-first-run branch from 6f5c477 to 7fa5628 Compare May 6, 2026 14:41
@airmang
Copy link
Copy Markdown
Owner Author

airmang commented May 6, 2026

Codex follow-up: rebased this PR branch onto current origin/main, resolved the README conflict, reran proposal quickcheck, and force-pushed the rebased branch.

Validation:

  • PYTHONPATH=/Users/wilycastle/Code/projects/python-hwpx/src /Users/wilycastle/Code/projects/python-hwpx/.venv/bin/python scripts/quickcheck.py --proposal → passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant