Skip to content

Add contributor, agent and brand documentation - #118

Merged
blizet merged 4 commits into
StabilityNexus:mainfrom
rohans02:docs/add-contributing
Aug 15, 2026
Merged

Add contributor, agent and brand documentation#118
blizet merged 4 commits into
StabilityNexus:mainfrom
rohans02:docs/add-contributing

Conversation

@rohans02

@rohans02 rohans02 commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds the contributor, agent and brand documentation this repository was missing, plus the AOSSIE best practices checklist.

  • CONTRIBUTING.md — development setup, coding style, PR process. The README's Contributing section now links to it instead of duplicating it. The org-wide PR template links [Contribution Guidelines](../CONTRIBUTING.md), which had no target in this repo until now.
  • AGENTS.md — the constraints that are easy to get wrong here: the out/.next collision, hand-maintained ABIs in src/utils/abi/, the five files a chain addition touches, and the three numeric scales (base-token decimals, WAD, DENOMINATOR).
  • BestPracticesChecklist.md — filled honestly at 33 of 49, counting justified N/A as met. Every unmet criterion carries a note on what closes it; warnings_fixed and test_policy are the notable ones.
  • brand/ — mark, icons, and Brand.md covering logo usage, palette, typography and contrast. Bruno confirmed on 11 Aug that no brand guidelines existed, so these are newly authored. Every value is taken from logo.svg or the codebase rather than invented.

Two deliberate choices worth flagging for review:

The brand/ assets are copies of the public/ ones. public/ is what the app serves and Navbar.tsx imports public/logo.svg as a module, so those cannot move. AGENTS.md records that the two locations must be updated together.

Brand.md documents Geist as the brand typeface and notes that it is loaded via next/font but never applied, because tailwind.config.ts does not consume the CSS variables and globals.css sets Arial. The two-line fix is deliberately excluded so that a change affecting every page is reviewed on its own.

AI Usage Disclosure:

We encourage contributors to use AI tools responsibly when creating Pull Requests. While AI can be a valuable aid, it is essential to ensure that your contributions meet the task requirements, build successfully, include relevant tests, and pass all linters. Submissions that do not meet these standards may be closed without warning to maintain the quality and integrity of the project. Please take the time to understand the changes you are proposing and their impact. AI slop is strongly discouraged and may lead to banning and blocking. Do not spam our repos with AI slop.

Check one of the checkboxes below:

  • This PR does not contain AI-generated code at all.
  • This PR contains AI-generated code. I have read the AI Usage Policy and this PR complies with this policy. I have tested the code locally and I am responsible for it.

Checklist

  • My PR addresses a single issue, fixes a single bug or makes a single improvement.
  • My code follows the project's code style and conventions
  • If applicable, I have made corresponding changes or additions to the documentation
  • If applicable, I have made corresponding changes or additions to tests
  • My changes generate no new warnings or errors
  • I have joined the Discord server and I will share a link to this PR with the project maintainers there
  • I have read the Contribution Guidelines
  • Once I submit my PR, CodeRabbit AI will automatically review it and I will address CodeRabbit's comments.
  • I have filled this PR template completely and carefully, and I understand that my PR may be closed without review otherwise.

Summary by CodeRabbit

  • Documentation
    • Added contributor guidance covering setup, development workflows, coding conventions, verification, issue reporting, and pull requests.
    • Added project guidance for development practices, repository boundaries, and workflow expectations.
    • Added an OpenSSF-aligned best-practices checklist with security, quality, reporting, and compliance criteria.
    • Added a canonical brand guide covering logo usage, colors, typography, icons, and accessibility requirements.
    • Updated the README to link to the new contribution guidance and support resources.

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@rohans02, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 21 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: a49a891e-35a0-4270-8da7-29a60827af48

📥 Commits

Reviewing files that changed from the base of the PR and between 2e9decc and 30f9964.

📒 Files selected for processing (5)
  • AGENTS.md
  • BestPracticesChecklist.md
  • CONTRIBUTING.md
  • SECURITY.md
  • brand/Brand.md

Walkthrough

Added repository guidance for contributors and AI coding agents, an OpenSSF-aligned practices checklist, updated README contribution links, and a canonical Fate Protocol brand guide.

Changes

Documentation and Guidance

Layer / File(s) Summary
Contributor workflow guidance
AGENTS.md, CONTRIBUTING.md, README.md
Added setup, architecture, coding, verification, Git workflow, contribution, issue-reporting, and support guidance. The README now links to the contributor documentation.
OpenSSF practice checklist
BestPracticesChecklist.md
Added checklist criteria, evidence, scoring, justifications, unmet requirements, and frontend/Web3 scope notes.
Fate Protocol brand guide
brand/Brand.md
Added documentation for assets, colours, accessibility contrast, icons, typography, and font-application limitations.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested labels: Documentation

Poem

A rabbit reads the guide by moonlit light,
Checks every step from day to night.
Brand colours bloom, clear and bright,
Contributions hop along just right.
“Well documented!” says the rabbit—delight.

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main documentation additions, although it does not mention the best-practices checklist.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@AGENTS.md`:
- Around line 35-37: Update the five-file chain checklist in AGENTS.md to
include src/utils/tokenList.ts, src/utils/rpcTransport.ts,
src/utils/supportedChainFeed.ts, and src/utils/explorer.ts, ensuring the
documentation reflects all required files for Ethereum Classic chain changes.

In `@BestPracticesChecklist.md`:
- Around line 129-130: Update the vulnerability_report_private checklist item in
BestPracticesChecklist.md to use [~] when private vulnerability reporting is not
supported, and add a justification stating that reports may be public; leave
vulnerability_report_process separately unmet, then recalculate and update all
affected summary values.
- Around line 115-119: Update the report_responses and enhancement_responses
checklist entries to avoid unsupported majority claims: provide reproducible
counts of applicable reports/requests and maintainer responses, or mark each
criterion unmet until sufficient evidence is available. Do not treat closed
issues as acknowledgments, and include a separate count for enhancement requests
and responses.
- Line 5: Remove the blank line inside the attribution blockquote in
BestPracticesChecklist.md, keeping all consecutive blockquote lines contiguous
so markdownlint MD028 no longer reports the issue.

In `@brand/Brand.md`:
- Around line 3-5: Clarify the animated logo’s source of truth in the brand
documentation: either add the missing canonical logo-animated.gif under brand/
and document its identical public/ mirror, or explicitly mark the public/ GIF as
non-canonical and specify how it is maintained.

In `@CONTRIBUTING.md`:
- Around line 22-25: Update the Node.js requirement in the “Install
dependencies” section of CONTRIBUTING.md to document the exact supported range
^18.18.0 || ^19.8.0 || >=20.0.0 instead of the broader “18 or later” wording.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 74be899c-296d-473a-9145-23485513c379

📥 Commits

Reviewing files that changed from the base of the PR and between 5ee6f06 and 2e9decc.

⛔ Files ignored due to path filters (5)
  • brand/apple-touch-icon.png is excluded by !**/*.png
  • brand/favicon.ico is excluded by !**/*.ico
  • brand/icon-192.png is excluded by !**/*.png
  • brand/icon-512.png is excluded by !**/*.png
  • brand/logo.svg is excluded by !**/*.svg
📒 Files selected for processing (5)
  • AGENTS.md
  • BestPracticesChecklist.md
  • CONTRIBUTING.md
  • README.md
  • brand/Brand.md

Comment thread AGENTS.md Outdated
Comment thread BestPracticesChecklist.md Outdated
Comment thread BestPracticesChecklist.md Outdated
Comment thread BestPracticesChecklist.md Outdated
Comment thread brand/Brand.md Outdated
Comment thread CONTRIBUTING.md Outdated
@blizet
blizet merged commit 1872769 into StabilityNexus:main Aug 15, 2026
4 checks 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.

2 participants