Skip to content

docs: add agent readiness documentation#324

Merged
tahmidefaz merged 1 commit intoRedHatInsights:masterfrom
platex-rehor-bot:bot/RHCLOUD-46732
Apr 16, 2026
Merged

docs: add agent readiness documentation#324
tahmidefaz merged 1 commit intoRedHatInsights:masterfrom
platex-rehor-bot:bot/RHCLOUD-46732

Conversation

@platex-rehor-bot
Copy link
Copy Markdown
Contributor

Summary

RHCLOUD-46732

  • Created CLAUDE.md with @AGENTS.md import and build/test/lint commands for Claude Code
  • Created AGENTS.md with project overview, tech stack, directory structure, federated module exports, key conventions (Jotai state, PatternFly 6, widget system, responsive grid, API layer), common pitfalls, and documentation index
  • Created CONTRIBUTING.md with setup instructions, development workflow, conventional commit format, and PR guidelines
  • Created docs/ARCHITECTURE.md with system design (Chrome shell integration, federated modules, Jotai atoms, two dashboard modes, backend API integration, responsive grid, widget mapping pipeline, deployment)
  • Created docs/testing-guidelines.md with Jest setup, required mocks (useChrome, Scalprum), Jotai test patterns, jsdom polyfills, API mocking, snapshot testing, and Playwright e2e
  • Created docs/component-development-guidelines.md with directory conventions, PatternFly 6 usage, atom/hook patterns, widget ID format, widget mapping structure, permission filtering, template data types, API integration, and styling
  • Updated README.md with a documentation index table linking to all new and existing docs

All changes are additive — no existing content was removed or modified (aside from the README documentation index update).

Test plan

  • Verify all file paths in documentation index resolve correctly
  • Verify code examples reference actual components/atoms/hooks from the codebase
  • Confirm no existing content was removed from README.md

🤖 Generated with Claude Code

RHCLOUD-46732

Add CLAUDE.md, AGENTS.md, CONTRIBUTING.md, docs/ARCHITECTURE.md,
docs/testing-guidelines.md, and docs/component-development-guidelines.md.
Update README.md with documentation index table. All changes are
additive — no existing content removed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@platex-rehor-bot platex-rehor-bot requested a review from a team as a code owner April 16, 2026 12:06
@platex-rehor-bot
Copy link
Copy Markdown
Contributor Author

/recheck

@platex-rehor-bot
Copy link
Copy Markdown
Contributor Author

/retest

@platex-rehor-bot
Copy link
Copy Markdown
Contributor Author

Konflux run-e2e-tests task failed again after /recheck + /retest. All other Konflux tasks (build, scans, unit tests) passed, and all GitHub Actions (install, lint, test-unit, build, cypress-component) are green.

This is a docs-only PR — no code, test, or config changes. PR #323 (which has code changes) passed the same Konflux e2e pipeline recently. The failure is likely a transient environment/infrastructure issue in the Konflux e2e test runner (Playwright + credentials + proxy setup).

Reviewers: the Konflux e2e failure is not related to these documentation changes. All code-quality checks pass.

@Hyperkid123
Copy link
Copy Markdown
Contributor

/retest

@tahmidefaz tahmidefaz merged commit a7801d5 into RedHatInsights:master Apr 16, 2026
7 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.

3 participants