Add backstage-cli repo fix --publish to code agent definition for new packages

クローズ 初心者向け
  • 何か問題がありますか？
#4,328 コメント 3 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
85/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
typescript
領域
developer-experience, tooling

調査の方向性

.fullsend/rhdh/agents/code.md を更新し、新しいパッケージに関するガイダンスを .fullsend/AGENTS.md と比較します。セクションに backstage-cli リポジトリの修正 --publish ワークフローと、一覧にあるパッケージセットアップのチェックが明示的に含まれていることを確認します。workspaces/ 配下の新しいパッケージについて、コードエージェントの定義がこれらの手順を明確に示していれば完了です。

索引モデルが issue の本文から書いたものです。

説明

ready-for-triage stale triaged

What happened

The code agent created a new Backstage package (boost-entity-provider-sdk) on PR #4212 via run 31327606763. The .fullsend/AGENTS.md instructions state: "When creating a new package under workspaces/, run yarn backstage-cli repo fix --publish at repo root after setup." The code agent did not run this step, producing inconsistent pluginPackages arrays — the new package listed itself among 7 sibling entries, but the 7 existing sibling packages still had 6-entry arrays that excluded the new package. The review agent caught the mismatch as an architectural-conflict finding, and the human fixed it in commit c98a25f by running backstage-cli repo fix --publish.

What could go better

The instruction exists in .fullsend/AGENTS.md but the code agent did not follow it. The most likely cause is a context-prominence gap: the instruction is in a shared instructions file loaded via redirect from AGENTS.md, while the code agent's primary definition (.fullsend/rhdh/agents/code.md) does not mention this step. When the code agent has a large context (reading issue specs, design docs, existing packages), a critical post-creation step buried in a general instructions file is easy to miss. Confidence: moderate — the code agent may have read the instruction but deprioritized it, or the redirect chain (AGENTS.md → .fullsend/AGENTS.md) may not have been followed. Either way, placing the instruction closer to the code agent's core context would help.

Proposed change

Add a "New package creation" section to .fullsend/rhdh/agents/code.md that includes the backstage-cli repo fix --publish step explicitly:

## New package creation

When creating a new package under `workspaces/`:
1. After initial package setup, run `yarn backstage-cli repo fix --publish` at the repo root to synchronize `pluginPackages` arrays across all sibling packages.
2. Run `yarn install` and `yarn dedupe` in the workspace directory.
3. Include the updated `yarn.lock` in your commit.
4. Verify that all sibling `package.json` files list the new package in their `pluginPackages` array.

This duplicates the instruction from .fullsend/AGENTS.md but places it in the code agent's primary definition where it's more likely to be in the agent's active context during package creation.

Validation criteria

The next code agent run that creates a new Backstage package under workspaces/ should include a backstage-cli repo fix --publish step. The resulting PR should have consistent pluginPackages arrays across all sibling packages, with no review finding for pluginPackages mismatch.

Generated by retro agent from https://github.com/redhat-developer/rhdh-plugins/pull/4212

主要言語
TypeScript
スター
51
フォーク
121
平均マージ
1日 17時間
マージ済み PR（30日）
270

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

redhat-developer/rhdh-plugins のほかの issue

redhat-developer/rhdh-plugins の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。