Skip to content

CONTRIBUTING.md — contribution workflow and branch policy #540

Description

@codebestia

Write CONTRIBUTING.md at the repo root. Cover: forking and branching, the required dev base branch, commit message conventions (Conventional Commits — feat:, fix:, docs:, with scopes like feat(backend):), how to link an issue so close-linked-issues.yml closes it on merge, the PR template, and which CI checks must pass before review.

Acceptance criteria:

  • States prominently and early that PRs must target dev, and that PRs to main are auto-closed by guard-main-branch.yml with a bot comment
  • Explains that the auto-close is not a rejection of the work — the contributor reopens against dev
  • Documents the commit convention actually used in this repo's history, with examples
  • Explains the Closes #N keyword behaviour and how close-linked-issues.yml handles it for dev merges
  • Lists the CI jobs a PR must pass, per touched area (backend / web / ai_agent / contracts)
  • Cross-linked from README.md

Activity

  1. Riel101 commented on Aug 27, 2026

    @Riel101

    @Riel101 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    Can I please work on this?

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Riel101 to this issue.

  2. eischideraa-unn commented on Aug 29, 2026

    @eischideraa-unn

    @eischideraa-unn has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    I'd like to take on this issue. I've worked on a similar fix recently and have a clear approach to implementing and validating the solution.

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @eischideraa-unn to this issue.

  3. Oluwatomilola commented on Sep 23, 2026

    @Oluwatomilola

    @Oluwatomilola has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    Hi.
    I can fix this issue. Kindly assign.

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwatomilola to this issue.

  4. Damola09 commented on Sep 28, 2026

    @Damola09
    Contributor

    @Damola09 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    Can i work on this?

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Damola09 to this issue.

  5. drips-wave commented on Sep 28, 2026

    @drips-wave

    Congratulations, @Damola09! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on September 30, 2026.

    🧑‍💻 @Damola09: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

    Warning

    When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

    🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

    🌊 Happy Wave 🌊

  6. added a commit that references this issue on Sep 29, 2026
    f81fd2a
  7. github-actions commented on Sep 29, 2026

    @github-actions

    Closed by #611, merged into dev.

  8. drips-wave commented on Sep 29, 2026

    @drips-wave

    This issue has been completed by @Damola09 as part of the Stellar Wave Program's 9th Wave 🥳

    😎 @Damola09: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

    🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

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

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave programdocumentationImprovements or additions to documentationdx

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions