Skip to content

Commit a55cf57

Browse files
fix(agents): address comments
1 parent b862387 commit a55cf57

4 files changed

Lines changed: 30 additions & 20 deletions

File tree

.github/agents/feature-implementer-agent.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,12 @@ Add JSDoc on every new or changed public member with `@param`, `@returns`, and `
9696

9797
---
9898

99+
## Agent Skills
100+
101+
Update component agent skills if you need to guide other agents on how to use the newly added feature.
102+
103+
---
104+
99105
## Final Self-Validation
100106

101107
Before finishing:

.github/agents/migration-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ You create **`ng update` migration schematics** for breaking changes in Ignite U
1818

1919
## When to Create Migrations
2020

21-
- API removed or renamed
21+
- API removed, renamed, or deprecated
2222
- Type or enum member renamed
2323
- Selector deprecated or changed
2424
- Component/directive moved to a different entry point

.github/agents/tdd-test-writer-agent.md

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -21,24 +21,26 @@ You are an independent specialist, not a plan executor. Read the user's request
2121
## How You Work
2222

2323
1. **Read the original request** — understand the real behavior being added, changed, or fixed.
24-
2. **Read the existing component source and spec files**understand the current implementation, current coverage, and the best place to extend tests.
25-
3. **Decide the smallest meaningful test set**for a small change, prefer **1 or 2 focused tests** that prove different behavior contracts.
26-
4. **Write the tests**prefer **2 small meaningful tests that cover different things** over 1 oversized test or many near-duplicate tests.
27-
5. Add a **third test only** if it proves a clearly distinct contract that the first 1 or 2 tests do not cover.
28-
6. **Run the tests** — confirm they fail for the intended missing behavior.
24+
2. **Identify the task type**determine whether the request is a **bug fix** or a **feature implementation**.
25+
3. **Read the existing component source and spec files**understand the current implementation, current coverage, and the best place to extend tests.
26+
4. **Decide the test scope based on task type**for a **bug fix**, focus on reproducing the issue and proving the fix with the smallest useful test set; for a **feature implementation**, cover the meaningful contracts of the new behavior while keeping the test set focused.
27+
5. **Write focused failing tests** that prove the intended behavior.
28+
6. **Run the tests** — confirm they fail for the intended missing functionality, or for existing functionality that does not function as intended.
2929

3030
You may collapse multiple requirements into fewer tests when one test can prove the contract clearly.
31-
Do not add extra scenarios or extra tests unless they are explicitly requested, clearly required by the feature contract, or needed for accessibility or backward compatibility.
31+
32+
Do not add extra scenarios unless they are explicitly requested, clearly required by the feature contract, or needed for accessibility or backward compatibility.
3233

3334
---
3435

3536
## Rules
3637

37-
1. **Default to the smallest useful test set.**
38-
- For a small additive change or bug fix, prefer **1 or 2 focused tests**.
39-
- Prefer **2 focused tests that cover different behaviors** over 1 oversized test.
40-
- Add a **third test only** if it proves a clearly distinct contract that the first 1 or 2 tests do not cover.
41-
- Do **not** write more than **3 new tests total** unless the user explicitly asks for broader coverage.
38+
1. **Choose test count based on task type.**
39+
- For a **bug fix**, prefer **1 or 2 focused tests**.
40+
- Add a **third bug-fix test only** if it proves a clearly distinct contract that the first 1 or 2 tests do not cover.
41+
- Do **not** write more than **3 new bug-fix tests total** unless the user explicitly asks for broader coverage.
42+
- For a **feature implementation**, add the meaningful tests needed to cover the feature contract.
43+
- Keep feature test sets focused, avoid unnecessary scenario matrices, and prefer distinct tests over repetition.
4244
2. **Prefer behavior-focused tests over API existence checks.**
4345
- Test observable behavior, emitted events, rendered state, or accessibility state.
4446
- Do not add tests whose only purpose is to verify that a symbol is exported, a member exists, or a property is publicly accessible.
@@ -52,7 +54,7 @@ Do not add extra scenarios or extra tests unless they are explicitly requested,
5254
- No shared mutable state.
5355
- No execution-order dependency.
5456
6. **Never write production code.**
55-
- Only test code in this phase.
57+
- Only test code in this phase to ensure the test does not give false negatives. The test MUST fail if the functionality is missing, or not behaving as intended.
5658

5759
---
5860

@@ -88,10 +90,11 @@ For bug fixes, write a test that reproduces the broken behavior — it must fail
8890

8991
Default to the smallest useful test set.
9092

91-
- Prefer **1 or 2 meaningful tests** for a small additive behavior or bug fix.
92-
- Prefer **2 smaller tests that cover different contracts** over **1 large test** that tries to verify everything.
93-
- Add a **third test only** when it proves a clearly distinct behavior that the first 1 or 2 tests do not cover.
94-
- **Maximum: 3 new tests total.**
93+
- For **bug fixes**, prefer **1 or 2 meaningful tests**.
94+
- For **bug fixes**, add a **third test only** when it proves a clearly distinct behavior that the first 1 or 2 tests do not cover.
95+
- For **bug fixes**, **maximum: 3 new tests total** unless the user explicitly asks for broader coverage.
96+
- For **feature implementations**, add the meaningful tests needed to cover the feature contract.
97+
- For **both** prefer smaller tests that cover distinct contracts over 1 large test that tries to verify everything.
9598
- Do not generate scenario matrices unless the user explicitly requests broad scenario coverage.
9699
- Do not split one small behavior into many tiny repetitive tests.
97100

@@ -152,9 +155,9 @@ Before finishing:
152155

153156
1. Run the smallest relevant test suite.
154157
2. Confirm the new tests fail for the intended missing behavior.
155-
3. Confirm the test set stays small and meaningful:
156-
- prefer 1 or 2 tests
157-
- add a 3rd only if it proves a clearly distinct contract
158+
3. Confirm the test set matches the task:
159+
- for **bug fixes**, prefer 1 or 2 tests and add a 3rd only if it proves a clearly distinct contract
160+
- for **feature implementations**, ensure the tests meaningfully cover the feature without padding or repetition
158161
4. Confirm you did not write production code.
159162

160163
---

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ css-naming-convention.md ← CSS naming rules
5656
- Add JSDoc with `@param`, `@returns`, and `@example` on every new public member.
5757
- Add or update `ng update` migrations for true breaking changes such as removals, renames, moved entry points, selector changes, or incompatible default-behavior changes.
5858
- Update the component `README.md` when the public API surface changes.
59+
- Update relevant Agent skills if a change is significant and/or you need to tell other agents how to use the newly introduced feature.
5960
- Consider demo/sample updates in `src/app/` for user-visible changes.
6061
- Update `CHANGELOG.md` for new features, deprecations, breaking changes, and notable user-visible fixes when they fit the existing changelog section structure.
6162

0 commit comments

Comments
 (0)