Skip to content

feat: improve contributor onboarding UX for claims and proposals#18

Merged
arjunastha merged 1 commit intosafe-agentic-framework:mainfrom
bishnubista:fix/contributor-onboarding-ux
Feb 21, 2026
Merged

feat: improve contributor onboarding UX for claims and proposals#18
arjunastha merged 1 commit intosafe-agentic-framework:mainfrom
bishnubista:fix/contributor-onboarding-ux

Conversation

@bishnubista
Copy link
Copy Markdown
Member

Summary

  • Fix Propose/Claim links to open GitHub issue forms (not raw YAML files)
  • Add seed dropdown to claim template so contributors select from a list
  • Add "How would you like to contribute?" dropdown (full write-up, co-author, add sections, review)
  • Add "How it works" table in README explaining the 5-step contributor flow
  • Move "Don't see your use case?" callout to after the crosswalk table
  • Rewrite claim workflow as a focused validator with welcoming bot messages
  • Improve tone across all contributor-facing surfaces (templates, bot comments, README)

Changes

File What changed
README.md Issue-creation URLs, "How it works" table, callout placement, softer tone
claim-existing-seed.yml Seed dropdown, contribution type dropdown, welcoming intro
propose-new-use-case.yml Warmer intro ("Thanks for proposing!")
assign-use-case-id.yml Rewritten as claim-only validator with friendly messages
auto-seed.yml Phase 1 comment thanks proposer, invites refinement
config.yml Removed stale reference to deleted template

Test plan

  • Verify Propose New Use Case link opens the form
  • Verify Claim Existing Seed link opens the form with dropdown
  • Confirm Registry and Docs Validation CI check passes
  • Review bot message tone in workflow files

🤖 Generated with Claude Code

README:
- Replace raw YAML file links with GitHub issue-creation URLs
  (/issues/new?template=...) so Propose/Claim open pre-filled forms
- Add "How it works" table with the 5-step contributor flow
- Move "Don't see your use case?" callout to after the crosswalk
  table where users land after scanning all seeds
- Soften safety-rules intro and replace "Bot" with "Automation"

Claim template (claim-existing-seed.yml):
- Replace free-text ID input with dropdown of all 29 available seeds
- Add "How would you like to contribute?" dropdown (full write-up,
  co-author, add sections, review/feedback)
- Welcoming intro encouraging collaboration on already-claimed seeds

Claim workflow (assign-use-case-id.yml):
- Rewrite as claim-only validator (proposals handled by auto-seed.yml)
- Parse SAFE-UC-XXXX from dropdown value
- Validate ID exists in registry with seed status
- Friendly conflict message encouraging co-authoring
- Warm success comment with next steps and invitation to ask questions

Proposal template & auto-seed workflow:
- Welcoming intro ("Thanks for proposing!")
- Phase 1 comment thanks proposer and invites refinement while waiting

Config (config.yml):
- Remove stale reference to deleted use-case-claim.yml template

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: bishnubista <bista.developer@gmail.com>
@arjunastha arjunastha merged commit 51efa03 into safe-agentic-framework:main Feb 21, 2026
2 checks passed
@bishnubista bishnubista deleted the fix/contributor-onboarding-ux branch February 21, 2026 21:35
techstar9797 pushed a commit to techstar9797/safe-agentic-use-cases that referenced this pull request Mar 17, 2026
…tributor-onboarding-ux

feat: improve contributor onboarding UX for claims and proposals
techstar9797 pushed a commit to techstar9797/safe-agentic-use-cases that referenced this pull request Mar 17, 2026
…tributor-onboarding-ux

feat: improve contributor onboarding UX for claims and proposals

Signed-off-by: Sachin Keswani <sachin.news@gmail.com>
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.

2 participants