[gabrielseco]

Summary

Adds a /goal Claude Code skill. It writes down what a feature or fix should do, and how it will be proven, and gets that agreed before any code is written.

Why

• On feat(onboarding): show job title eligibility statements for maybe and not eligible roles #1508, coding started on the wrong flow (contractor eligibility instead of EOR job title eligibility) because the goal hadn't been agreed first.
• Unit tests passed, but checking the feature against the real API meant rediscovering env problems one at a time: which company has the feature flags, input limits that stop the check from firing, shared sandbox endpoints.
• A written goal with verification claims and known gotchas means the next run already knows these.

What changed

Toggle details

• New .claude/skills/goal/SKILL.md. Steps: find the target flow (ask when ambiguous), draft Goal / Scope / Copy / Out of scope / Open questions / Verification, stop for approval, show only the changed sections on each round, then save.
• Verification is one row per claim with observable evidence (API response, visible text, screenshot name), plus env, seed, route and gotchas. It points at the existing verify-local-app / verify-sandbox-deployed-app skills to run them.
• Goals are stored at ~/.claude/goals/<project>/<branch>.md, outside the repo: they never land in a PR and survive removing the worktree. <project> is the main checkout's directory, so worktrees share it.
• A separate /verify skill that runs the claims automatically is deferred to a later PR.
• No library code or public API changes.

Screenshots

N/A

Related Resources

• feat(onboarding): show job title eligibility statements for maybe and not eligible roles #1508

Testing

• Run /goal on a new feature: it asks about an ambiguous flow before exploring, writes no code before approval, and saves the file under ~/.claude/goals/remote-flows/.
• Feature flag: N/A

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only Claude skill with no runtime, library, or public API changes.

Overview
Adds a new /goal Claude Code skill (.claude/skills/goal/SKILL.md) so feature work starts with an agreed written target before any code or branch creation.

The skill defines a four-step workflow: resolve ambiguous flows up front, draft fixed sections (Branch, Goal, Scope, Copy, Out of scope, Open questions, Verification), iterate by showing only changed sections until approval, then save with approved frontmatter. Verification requires one table row per claim with observable evidence (env, seed, route, screenshots, gotchas), and ties env to the existing verify-local-app / verify-sandbox-deployed-app skills. Approved goals live at ~/.claude/goals/<project>/<branch>.md outside the repo; scope changes call out src/index.tsx as public API. A separate /verify automation skill is explicitly deferred.

^{Reviewed by Cursor Bugbot for commit 534ddf5. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Deploy preview for remote-flows ready!

Project:	remote-flows
Status:	✅  Deploy successful!
Preview URL:	https://remote-flows-j99hpahpg-remotecom.vercel.app
Latest Commit:	534ddf5

Deployed with vercel-action

[github-actions]

Deploy preview for adp-cost-calculator ready!

Project:	adp-cost-calculator
Status:	✅  Deploy successful!
Preview URL:	https://adp-cost-calculator-4mxw3jxxf-remotecom.vercel.app
Latest Commit:	534ddf5

Deployed with vercel-action

[github-actions]

📊 Coverage Report

⚪ Coverage unchanged

Metric	Current	Previous	Change	Status
Lines	89.53%	89.53%	0%	⚪
Statements	89.40%	89.40%	0%	⚪
Functions	88.41%	88.41%	0%	⚪
Branches	81.14%	81.14%	0%	⚪

Detailed Breakdown

Lines Coverage

• Covered: 5385 / 6015
• Coverage: 89.53%
• Change: 0% (0 lines)

Statements Coverage

• Covered: 5450 / 6096
• Coverage: 89.40%
• Change: 0% (0 statements)

Functions Coverage

• Covered: 1426 / 1613
• Coverage: 88.41%
• Change: 0% (0 functions)

Branches Coverage

• Covered: 3339 / 4115
• Coverage: 81.14%
• Change: 0% (0 branches)

✅ Coverage check passed

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f1949d4. Configure here.}

[gabrielseco]

Closing: keeping this skill local instead of shipping it in the repo.