Skip to content

[#183] Auto-generate CLAUDE.md for agent skill discovery#185

Merged
realproject7 merged 2 commits into
mainfrom
task/183-auto-generate-claude-md
May 14, 2026
Merged

[#183] Auto-generate CLAUDE.md for agent skill discovery#185
realproject7 merged 2 commits into
mainfrom
task/183-auto-generate-claude-md

Conversation

@realproject7
Copy link
Copy Markdown
Owner

Summary

  • On app startup, writes/updates ~/.plotlink-ows/CLAUDE.md with full API reference (auth, all endpoints, workflows, valid genres/languages)
  • Version-stamped: skips the write if the file already matches the current package version, regenerates on version bumps
  • Claude sessions spawned in story directories auto-discover the docs via directory-tree walk

Fixes #183

Test plan

  • Start the app (npm run app:dev) and verify ~/.plotlink-ows/CLAUDE.md is created
  • Confirm file contains all API endpoints, genres, and languages
  • Restart the app — file should NOT be rewritten (same version)
  • Bump version in package.json, restart — file should update

🤖 Generated with Claude Code

On each app startup, writes/updates ~/.plotlink-ows/CLAUDE.md with full
API reference (auth, endpoints, workflows, genres, languages). Skips the
write if the file already matches the current version. Claude sessions
spawned in story directories auto-discover this file.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator

@project7-interns project7-interns left a comment

Choose a reason for hiding this comment

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

Verdict: APPROVE

Summary

The startup generator creates ~/.plotlink-ows/CLAUDE.md with the local writer API reference and wires it into app startup before the server begins serving. The generated docs cover the current auth, publish, stories, terminal, settings, wallet, dashboard, health endpoints, workflows, genres, and languages.

Findings

  • No blocking findings.

Decision

Approved. CI lint-and-typecheck is passing, and the implementation satisfies issue #183 acceptance criteria.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@realproject7 realproject7 merged commit 61142c4 into main May 14, 2026
1 check 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.

Auto-generate CLAUDE.md in ~/.plotlink-ows/ for agent skill discovery

2 participants