Skip to content

[User Story] Update CLAUDE.md with ephemeral compose documentation #91

@noahwhite

Description

@noahwhite

Story Summary

As a platform engineer, I want to update CLAUDE.md with documentation for the ephemeral compose approach, so that future maintainers understand the architecture and secrets management.


✅ Acceptance Criteria

  • Architecture section added explaining ephemeral vs persistent components
  • Secrets management section documenting .env.config vs .env.secrets split
  • Upstream update workflow documented (how to sync with TryGhost/ghost-docker)
  • Files to monitor for updates listed
  • Common operations updated (e.g., where to find compose files)
  • Migration checklist included for reference

📝 Additional Context

  • Design: Documentation should be actionable and include specific file paths
  • Include the GitHub watch + manual sync workflow for upstream updates
  • Reference the threat model for secrets management decisions

📦 Definition of Ready

  • Acceptance criteria defined
  • No unresolved external dependencies
  • Story is estimated
  • Team has necessary skills and access
  • Priority is clear
  • Business value understood

✅ Definition of Done

  • All acceptance criteria met
  • Documentation is clear and accurate
  • Peer-reviewed
  • No sensitive information in documentation

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions