Skip to content

Add simple AI Harness#1352

Merged
stevepolitodesign merged 1 commit into
mainfrom
sp-ai-harness
Apr 29, 2026
Merged

Add simple AI Harness#1352
stevepolitodesign merged 1 commit into
mainfrom
sp-ai-harness

Conversation

@stevepolitodesign

@stevepolitodesign stevepolitodesign commented Apr 27, 2026

Copy link
Copy Markdown
Contributor

Relates to #1350 and
#1351.

We introduced thoughtbot agents
rules
to our guides a
few months ago. This commit simply pulls those files into newly
generated Suspenders applications. There's a case to be made that these
should be kept separate, but I like having a single source of truth.

Comment thread lib/templates/web.rb
Comment on lines +534 to +537
empty_directory ".claude"
empty_directory ".claude/rules"

get "#{base_url}/CLAUDE.md", ".claude/CLAUDE.md"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

One issue here is this is Claude-specific. That works for thoughtbot, but do we want to support other services?

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.

FYI it's being discussed here thoughtbot/guides#786 (comment)

@jaredlt

jaredlt commented Apr 28, 2026

Copy link
Copy Markdown
Contributor

This looks great!

Annoyingly, this will include the usage section which we've effectively already done. I can't think of a non-fragile way to include these. Unless perhaps we add a README.md in the same guides folder with these instructions and then the CLAUDE.md is "ready" to use, they just need to update the app name and add the sentence on app context. @laicuRoot what do you think?

@stevepolitodesign

Copy link
Copy Markdown
Contributor Author

@jaredlt @laicuRoot alternatively, would it be worth making Suspenders the source of truth for this? Then, we could update the Guides to link to these files?

@laicuRoot

Copy link
Copy Markdown
Contributor

Hey folks!

I think extracting the instructions to a README makes sense @jaredlt 👍

would it be worth making Suspenders the source of truth for this?

🤔 I'm not sure about this @stevepolitodesign. Shouldn't our guides be the source of truth for how we work and how we recommend writing code? In any case, if you think that would make the rules more "maintainable" I'm ok with it.

By the way, now rails ships with an AGENT.md file.

@jaredlt

jaredlt commented Apr 28, 2026

Copy link
Copy Markdown
Contributor

I believe the AGENTS.md file in the Rails repo is more about contributing to the rails repo, and not so much about developing apps using rails.

I can't decide what is best about the source of truth for where this should live :)

@stevepolitodesign

Copy link
Copy Markdown
Contributor Author

@jaredlt @laicuRoot I've opened thoughtbot/guides#789 to address the concerns mentioned in this PR. Once that merges, we can merge this.

Comment thread lib/templates/web.rb
Relates to #1350 and
#1351.

We introduced [thoughtbot agents
rules](thoughtbot/guides#783) to our guides a
few months ago. This commit simply pulls those files into newly
generated Suspenders applications. There's a case to be made that these
should be kept separate, but I like having a single source of truth.
@stevepolitodesign

stevepolitodesign commented Apr 29, 2026

Copy link
Copy Markdown
Contributor Author

@jaredlt @laicuRoot now that thoughtbot/guides#789 has merged, I think we're in a good state. You can also manually test this by pulling down the project and running bin/qa..

We also have coverage in CI.

@jaredlt jaredlt 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.

Looks good!

I think we can explore supporting other agents etc in a future iteration.

@laicuRoot laicuRoot 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.

🦾

@stevepolitodesign stevepolitodesign merged commit 813680b into main Apr 29, 2026
2 checks passed
@stevepolitodesign stevepolitodesign deleted the sp-ai-harness branch April 29, 2026 14:47
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