Skip to content

docs: consolidate CLAUDE.md architecture docs into AGENTS.md#2933

Merged
bjagg merged 1 commit into
uPortal-Project:masterfrom
bjagg:chore/consolidate-agents-md
Apr 1, 2026
Merged

docs: consolidate CLAUDE.md architecture docs into AGENTS.md#2933
bjagg merged 1 commit into
uPortal-Project:masterfrom
bjagg:chore/consolidate-agents-md

Conversation

@bjagg

@bjagg bjagg commented Apr 1, 2026

Copy link
Copy Markdown
Member
Checklist
Description of change

Consolidates the architecture documentation from CLAUDE.md into the existing AGENTS.md, which is the more comprehensive and actively maintained agent guide.

Added to AGENTS.md (new Architecture section after Project Structure):

  • Rendering pipeline — 9-stage decorator pattern chain
  • Distributed Layout Management (DLM) — fragment merging, evaluators
  • Authentication — 4 ISecurityContext implementations
  • Import/Export — JaxbPortalDataHandlerService and related interfaces
  • Soffit framework — JWT-based portlet alternative
  • Spring configuration — mixed XML/Java, convention-based discovery
  • Key configuration files — portal.properties, rdbm.properties, etc.
  • Dependency coupling — hub vs leaf module relationships

Removed CLAUDE.md — its remaining content (build commands, tech stack, code style) was already covered more thoroughly in AGENTS.md. CLAUDE.md also had stale info (Java 8, Node 20, old Lombok version).

Move the architecture section from CLAUDE.md into AGENTS.md, which
is the more comprehensive and actively maintained agent guide. Added:

- Rendering pipeline stages (9-stage decorator pattern)
- Distributed Layout Management (DLM) explanation
- Authentication implementations (4 ISecurityContext types)
- Import/Export system (JaxbPortalDataHandlerService)
- Soffit framework overview
- Spring configuration details (mixed XML/Java)
- Key configuration files
- Dependency coupling info

Remove CLAUDE.md as its remaining content (build commands, tech stack,
code style) was already covered more thoroughly in AGENTS.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@bjagg bjagg self-assigned this Apr 1, 2026
@bjagg bjagg requested a review from ChristianMurphy April 1, 2026 01:45
@bjagg bjagg merged commit 3b07880 into uPortal-Project:master Apr 1, 2026
5 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.

2 participants