[design-system-agent] Refined project docs

[halocline]

Deploy Preview

What does this PR do?

This pull request introduces comprehensive documentation for the design-system-agent project, outlining its purpose, architecture, agent roles, evaluation and remediation workflow, configuration, framework support, data flow, privacy, and troubleshooting guidance. The documentation is designed to help both designers and developers understand how the system increases UI consistency and quality across HPE product teams, and how it operates using a multi-agent orchestration model.

Project Overview and Architecture:

• Added detailed background, goals, and intent for the project, emphasizing its role in enabling consistent UI development and continuous improvement through design system alignment.
• Described the multi-agent orchestration architecture, including specialized agents (orchestrator, auditor, strategist, engineer, reporter) and their responsibilities within the CLI package.

Workflow and Implementation:

• Documented the continuous improvement loop phases (scan, score, plan, fix, verify, report) and provided a master sequence diagram for agent interactions and data handoffs.
• Explained configuration via .hpedsrc, including required and optional fields, file discovery order, and recommendations for version control.

Framework and Extensibility:

• Outlined framework support, detection logic, roadmap, and fallback behavior for unsupported frameworks, including modular skill loading for agents.
• Provided tables

What are the relevant issues?

Where should the reviewer start?

How should this be manually tested?

Any background context you want to provide?

Screenshots (if appropriate)

Should this PR be mentioned in Design System updates?

Is this change backwards compatible or is it a breaking change?

[changeset-bot]

⚠️ No Changeset found

Latest commit: 25ecf73

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify]

✅ Deploy Preview for hpe-theme-preview ready!

Name	Link
🔨 Latest commit	25ecf73
🔍 Latest deploy log	https://app.netlify.com/projects/hpe-theme-preview/deploys/69a47df4ee75e600085a4850
😎 Deploy Preview	https://deploy-preview-5871--hpe-theme-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[netlify]

✅ Deploy Preview for hpe-design-icons-grommet ready!

Name	Link
🔨 Latest commit	25ecf73
🔍 Latest deploy log	https://app.netlify.com/projects/hpe-design-icons-grommet/deploys/69a47df42f26da0008595870
😎 Deploy Preview	https://deploy-preview-5871--hpe-design-icons-grommet.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[netlify]

✅ Deploy Preview for unrivaled-bublanina-3a9bae ready!

Name	Link
🔨 Latest commit	25ecf73
🔍 Latest deploy log	https://app.netlify.com/projects/unrivaled-bublanina-3a9bae/deploys/69a47df47818620008f36df8
😎 Deploy Preview	https://deploy-preview-5871--unrivaled-bublanina-3a9bae.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.