layer5io / layer5io/recognition
[Docs] Add AGENTS.md with Sistent design guidance
Open
@PARTH-TUSSLE is already working on this.
Since Sep 15, 2026.
area/docs
framework/jekyll
language/markdown
- Dominant language
- JavaScript
- Stars
- 23
- Forks
- 15
- Avg merge
- 3h 18m
- Merged PRs (30d)
- 3
Description
Current State
The layer5io/recognition repository does not currently have an AGENTS.md file.
The repository consumes @sistent/sistent@0.15.12, but there is no contributor or AI-agent guidance directing UI-related work to the Sistent design contract.
Desired State
Create a lightweight root-level AGENTS.md documenting basic runbook setup and providing a version-accurate reference to Sistent for UI components.
Guidance Requirements
- Version Parity: Because the repository is pinned to
@sistent/sistent@0.15.12, direct contributors and AI coding agents to readnode_modules/@sistent/sistent/DESIGN.md(or link to the matching release tag:https://github.com/layer5io/sistent/tree/v0.15.12/DESIGN.md) rather thanmaster, preventing guidance drift against newer Sistent versions. - Single Source of Truth: Instruct agents to consult Sistent's design tokens and conventions before introducing or modifying Sistent-based UI components.
- Avoid Duplication: Do not copy or create a separate
DESIGN.mdin this repository.
Scope
- Create a concise
AGENTS.mdat the repository root. - Include essential project setup/runbook steps.
- Add the Sistent UI contract pointer under UI guidelines.
- Keep the file compact and focused.
Contributor Guides and Resources
- 📚 Instructions for contributing to documentation
- 🛠 Meshery Build & Release Strategy
- 🎨 Wireframes and designs for Layer5 site in Figma (open invite)
- 🙋🏾🙋🏼 Questions: Layer5 Discussion Forum and Layer5 Community Slack
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.