Skip to content

docs: Add CLAUDE.md documentation for key .NET projects#20841

Merged
Migaroez merged 9 commits intoumbraco:mainfrom
hifi-phil:v17/docs/claude-memories
Nov 25, 2025
Merged

docs: Add CLAUDE.md documentation for key .NET projects#20841
Migaroez merged 9 commits intoumbraco:mainfrom
hifi-phil:v17/docs/claude-memories

Conversation

@hifi-phil
Copy link
Contributor

Description

Some Claude memory files that have been generated against a template to attempt to standardise memory file product for Umbraco

Add comprehensive CLAUDE.md files for major Umbraco projects:

  • Root CLAUDE.md: Multi-project repository overview
  • Umbraco.Core: Interface contracts and domain models
  • Umbraco.Infrastructure: Implementation layer (NPoco, migrations, services)
  • Umbraco.Cms.Api.Common: Shared API infrastructure
  • Umbraco.Cms.Api.Management: Management API (1,317 files, 54 domains)
  • Umbraco.Web.UI.Client: Frontend with split docs structure

Each file includes:

  • Architecture and design patterns
  • Project-specific workflows
  • Edge cases and gotchas
  • Commands and setup
  • Technical debt tracking

Add comprehensive CLAUDE.md files for major Umbraco projects:
- Root CLAUDE.md: Multi-project repository overview
- Umbraco.Core: Interface contracts and domain models
- Umbraco.Infrastructure: Implementation layer (NPoco, migrations, services)
- Umbraco.Cms.Api.Common: Shared API infrastructure
- Umbraco.Cms.Api.Management: Management API (1,317 files, 54 domains)
- Umbraco.Web.UI.Client: Frontend with split docs structure

Each file includes:
- Architecture and design patterns
- Project-specific workflows
- Edge cases and gotchas
- Commands and setup
- Technical debt tracking

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Contributor

@AndyButland AndyButland left a comment

Choose a reason for hiding this comment

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

Seems pretty good to me @hifi-phil. I've given just a cursory review to check it's on the right track and added a few comments where I saw errors.

@AndyButland AndyButland requested a review from Migaroez November 15, 2025 11:55
Copy link
Contributor

@iOvergaard iOvergaard left a comment

Choose a reason for hiding this comment

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

Added a few suggestions around the Client. In general, some of the agentic actions are over-simplified, but I'm not sure if the agent can figure it out by looking at the existing code anyway.

In the future, we might have use of more flows, such as:

  • Adding a dashboard
  • Adding a workspace
  • Using the existing Content workspace

@hifi-phil
Copy link
Contributor Author

In the future, we might have use of more flows, such as:

  • Adding a dashboard
  • Adding a workspace
  • Using the existing Content workspace

I have a plan to provide this type of knowledge using Claude Code Skills. This will allow us to supply much more specific knowledge including examples, guides, etc in a context efficient way.

hifi-phil and others added 4 commits November 17, 2025 12:00
Co-authored-by: Jacob Overgaard <752371+iOvergaard@users.noreply.github.com>
Co-authored-by: Andy Butland <abutland73@gmail.com>
Co-authored-by: Jacob Overgaard <752371+iOvergaard@users.noreply.github.com>
- Clarify NPoco is current and fully supported (not legacy)
- Document EF Core as future direction with ongoing migration
- Add secure cookie-based token storage details for v17+
- Update OpenIddict authentication documentation
- Update API versioning (v1.0 and v1.1)
- Minor documentation cleanups (community links, descriptions)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Contributor

@Migaroez Migaroez left a comment

Choose a reason for hiding this comment

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

I will make the proposed changes myself now that I have access to your fork.
Other things todo:

  • check patch strategy with Kenn
  • Cleanup double info in project files that are already the root file

@Migaroez
Copy link
Contributor

@iOvergaard @AndyButland

If you are both happy with the changes made by @hifi-phil then It's ready for me to be merged in.

@hifi-phil
Copy link
Contributor Author

Looks good to me

Copy link
Contributor

@iOvergaard iOvergaard left a comment

Choose a reason for hiding this comment

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

LGTM

@Migaroez Migaroez enabled auto-merge (squash) November 25, 2025 14:32
@Migaroez Migaroez merged commit ef282a5 into umbraco:main Nov 25, 2025
28 checks 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.

4 participants