Skip to content

Edit README.md to improve AI assistant guide for the codebase - #1032

Merged
jrhender merged 5 commits into
masterfrom
algon-add-agents-md
Mar 2, 2026
Merged

jrhender merged 5 commits into
masterfrom
algon-add-agents-md

Conversation

@Algon-33

Copy link
Copy Markdown
Collaborator

This adds an AGENTS.md file to help AI coding assistants (Claude, Gemini, GPT, etc.) quickly understand the stampy-ui codebase.

Contents

  • Project overview and tech stack
  • Code style (Prettier/ESLint rules)
  • Project structure
  • Key files to know
  • Data flow explanation
  • Common commands
  • Environment variables
  • Git workflow
  • Common gotchas (Windows build issues, Prettier enforcement, etc.)
  • Architecture notes

This should help onboard any AI assistant working on this repo.

Comment thread AGENTS.md Outdated

## Local Development Setup

1. Copy `wrangler.toml.template` → `wrangler.toml`

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

These two lines are repeats from README.md, and I'm afraid that if the LLM reads them literally it could overwrite functional wrangler.toml files

Comment thread AGENTS.md Outdated
**Workaround:** Use `npm run dev` locally. CI builds on Linux.

### 2. Prettier Formatting in PRs
CI enforces Prettier. If your PR fails with formatting errors:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

My understanding is that prettier should be run before committing. If we forget, I tend to use git commit --amend --no-edit and git push --force-with-lease if it's been pushed already, but that's not ideal either.

Comment thread AGENTS.md Outdated
1. Add/modify SVGs in `app/assets/icons/`
2. Run `npm run generate-icons`

### 4. wrangler.toml is Gitignored

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The README specified this, I don't think it's needed here.

- Remove duplicate setup steps that could cause wrangler.toml overwrites

- Rewrite Prettier section to emphasize pre-commit formatting

- Remove redundant wrangler.toml gitignore note (already in README)
LeMurphant
LeMurphant previously approved these changes Feb 2, 2026

@LeMurphant LeMurphant left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@jrhender jrhender changed the title Add AGENTS.md - AI assistant guide for the codebase Edit README.md to improve AI assistant guide for the codebase Feb 23, 2026
@jrhender
jrhender merged commit 8f84e8d into master Mar 2, 2026
1 check passed
@jrhender
jrhender deleted the algon-add-agents-md branch March 2, 2026 01:30
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.

3 participants