Skip to content

Script for agents#1223

Open
Kasinhou wants to merge 2 commits intodtq-devfrom
agents-md-script
Open

Script for agents#1223
Kasinhou wants to merge 2 commits intodtq-devfrom
agents-md-script

Conversation

@Kasinhou
Copy link

@Kasinhou Kasinhou commented Feb 25, 2026

2.3 Prompt Template — Copy, Fill In, Paste to Agent

Here is the GitHub issue to fix: <PASTE ISSUE URL>

Read the agent guide at docs/agents.md first.

Environment info:
- Backend services (REST API, Solr, PostgreSQL) are running in Docker on default ports
- Frontend will run locally (you start it with yarn start:dev or yarn serve:ssr)
- Admin credentials if necessary for the issue: <PASTE EMAIL>/<PASTE PASSWORD>

Please:
1. Read the issue and understand the problem
2. Use Playwright MCP to navigate to the affected page and visually confirm the bug
3. Investigate the codebase to find the root cause
4. Implement a fix
5. Use Playwright MCP again to verify the fix is working
6. Run all CI checks (lint → circ-deps → build → unit tests) and iterate until all pass
7. Only commit and push when everything is green

If the issue involves a specific page, here is the direct URL: <OPTIONAL URL>

That's it. Everything below is the agent's responsibility.

Sync verification

If en.json5 or cs.json5 translation files were updated:

  • Run yarn run sync-i18n -t src/assets/i18n/cs.json5 -i to synchronize messages, and changes are included in this PR.

Manual Testing (if applicable)

Copilot review

  • Requested review from Copilot

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new documentation guide (docs/agents.md) describing how to delegate work to AI coding agents (and how humans should prepare/run the local environment) in the context of this DSpace Angular fork and its CI pipeline.

Changes:

  • Introduces an “Agent & User Guide” covering local setup, CI-equivalent command sequence, and common pitfalls.
  • Documents Docker-based backend startup for Cypress e2e runs and provides a “quick reference” command list.
  • Captures known pre-existing e2e failures and troubleshooting tips to reduce wasted iteration time.

@Kasinhou Kasinhou requested a review from milanmajchrak March 9, 2026 12:20
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