layer5io / layer5io/layer5

[Docs] Update AGENTS.md and synchronize CLAUDE.md with Sistent design guidance

Open
#8,061 1 comment 0 reactions 1 assignee View on GitHub

@PARTH-TUSSLE is already working on this.

Since Sep 15, 2026.

help wanted kind/chore
Dominant language
JavaScript
Stars
1.1k
Forks
1.6k
Avg merge
2d 10h
Merged PRs (30d)
18

Description

Current Behavior

The layer5io/layer5 repository already has an AGENTS.md, but its UI styling guidance still refers to "Tailwind/CSS modules" without accounting for the repository's dependency on Sistent.

This can leave contributors and AI coding agents without a clear reference to the shared Sistent design contract when making UI changes.

Desired Situation

Update the existing AGENTS.md to reference Sistent's design contract for UI guidance.

The updated guidance should:

  • Reference @sistent/sistent for shared UI components and styling.
  • Point contributors and AI coding agents to sistent/DESIGN.md for the design contract, tokens, and UI conventions.
  • Replace or update the outdated "Tailwind/CSS modules" styling guidance where appropriate.
  • Avoid duplicating the contents of sistent/DESIGN.md inside this repository.

The goal is to keep the repository's agent/contributor guidance aligned with Sistent while maintaining a single source of truth for the design system.


Contributor Resources and Handbook

The layer5.io website uses Gatsby, React, and GitHub Pages. Site content is found under the master branch.

Join the Layer5 Community by submitting your community member form.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.