Skip to content

fix(skills): move context references to parent skill resources#155

Merged
janhesters merged 4 commits intomainfrom
fix/context-refs-as-skill-resources
Mar 18, 2026
Merged

fix(skills): move context references to parent skill resources#155
janhesters merged 4 commits intomainfrom
fix/context-refs-as-skill-resources

Conversation

@janhesters
Copy link
Collaborator

@janhesters janhesters commented Mar 17, 2026

Summary

  • Move aidd-redux-example from standalone skill to aidd-autodux/references/redux-example.md (closes Redux example should be context for autodux skill #153)
  • Move aidd-timing-safe-vulnerabilities from standalone skill to aidd-timing-safe-compare/references/vulnerabilities.md (closes Timing safe compare vulnerabilities should be docs #152)
  • Move ai/rules/review-example.md to aidd-review/references/review-example.md
  • Move ai/rules/user-testing.test.js to aidd-user-testing/user-testing.test.js
  • Remove empty ai/rules/ directory
  • Update all cross-references and index files
  • Apply biome lint auto-fixes

Test plan

  • All 346 unit tests pass
  • All 393 tests pass (including e2e)
  • Moved user-testing.test.js passes with updated paths
  • Lint and typecheck pass
  • Verify skills are discovered correctly by Claude Code

Code Review Findings

❌ One Required Fix Before Merge

Issue: docs/learn-aidd-framework.md (newly added) contains stale references to old paths

Lines 7-10, 24 reference non-existent paths:

  • ai/rules/productmanager.mdc → should be ai/skills/aidd-product-manager/SKILL.md
  • ai/rules/requirements.mdc → should be ai/skills/aidd-functional-requirements/SKILL.md
  • ai/rules/tdd.mdc → should be ai/skills/aidd-tdd/SKILL.md
  • ai/rules/sudolang/ → should be ai/skills/aidd-sudolang-syntax/SKILL.md

Impact: Broken documentation links for users learning the framework

✅ Review Summary

  • Security: ✅ No vulnerabilities (OWASP Top 10 reviewed)
  • Test Coverage: ✅ All 393 tests passing
  • Code Quality: ✅ Excellent commit structure, comprehensive cross-reference updates
  • Structure: ✅ Clean migration of reference materials to parent skills
  • Documentation: ✅ Major README improvements, but one new file needs fixing

Overall Recommendation: APPROVE WITH ONE REQUIRED FIX

Full review details available in PR comments.

Open in Web Open in Cursor 

…ources

Redux example, timing-safe vulnerabilities, and review example were
incorrectly converted to standalone skills during the rules-to-skills
migration. They are reference documentation, not actionable skills.

- Move aidd-redux-example → aidd-autodux/references/redux-example.md
- Move aidd-timing-safe-vulnerabilities → aidd-timing-safe-compare/references/vulnerabilities.md
- Move review-example.md → aidd-review/references/review-example.md
- Move user-testing.test.js → aidd-user-testing/user-testing.test.js
- Remove empty ai/rules/ directory
- Update all cross-references and index files
- Strip skill frontmatter from reference files

Closes #152, closes #153
@ericelliott
Copy link
Collaborator

@cursoragent please /review

@cursor
Copy link
Contributor

cursor bot commented Mar 17, 2026

Taking a look!

Open in Web Open in Cursor 

@ericelliott
Copy link
Collaborator

@cursoragent please /aidd-review

@cursor
Copy link
Contributor

cursor bot commented Mar 17, 2026

I've already completed a comprehensive code review following the AIDD review process. Here are the key findings:

🔬 Code Review Summary

Overall Assessment: ✅ APPROVE WITH ONE REQUIRED FIX

Score: 8.7/10 overall

This is a well-executed refactoring with clean commits, comprehensive cross-reference updates, and all 393 tests passing. Security review (OWASP Top 10) shows no vulnerabilities.


❌ Critical Issue (Must Fix Before Merge)

File: docs/learn-aidd-framework.md (lines 7-10, 24)

Problem: Stale references to old file structure that no longer exists

Current (broken):

- [Product Management](../ai/rules/productmanager.mdc)
- [User Story Mapping](../ai/rules/productmanager.mdc)
- [Functional Requirements](../ai/rules/requirements.mdc)
- [Test Driven Development](../ai/rules/tdd.mdc)
- [SudoLang Syntax and Best Practices](../ai/rules/sudolang/)

Required fix:

- [Product Management](../ai/skills/aidd-product-manager/SKILL.md)
- [User Story Mapping](../ai/skills/aidd-product-manager/SKILL.md)
- [Functional Requirements](../ai/skills/aidd-functional-requirements/SKILL.md)
- [Test Driven Development](../ai/skills/aidd-tdd/SKILL.md)
- [SudoLang Syntax and Best Practices](../ai/skills/aidd-sudolang-syntax/SKILL.md)

✅ Strengths

  1. Clean Migration: Reference materials properly moved to parent skill references/ directories
  2. Comprehensive Updates: 88 files updated with correct cross-references
  3. Test Coverage: All 393 tests passing, including relocated user-testing.test.js
  4. Commit Quality: Atomic commits with conventional format, proper issue closure
  5. Security: No vulnerabilities (OWASP Top 10 reviewed), proper token handling
  6. README: Major improvements with new learning sections

📊 Detailed Scores

Criterion Score Assessment
Code Structure 9/10 Excellent organization
Test Coverage 10/10 All tests pass
Documentation 7/10 Good, but one file needs fixing
Security 10/10 No vulnerabilities
Best Practices 9/10 Consistent AIDD standards
Commit Quality 10/10 Exemplary

🎯 Action Required

  1. Fix the 5 broken links in docs/learn-aidd-framework.md
  2. Once fixed, this PR is ready to merge

Risk Level: LOW (structural changes only)
Confidence: HIGH (comprehensive testing and review completed)

Open in Web Open in Cursor 

cursoragent and others added 2 commits March 17, 2026 18:03
Co-authored-by: Eric Elliott <support@paralleldrive.com>
Update broken links that still pointed to the old ai/rules/ paths
to use the new ai/skills/ structure.
@janhesters janhesters merged commit 8cc0a6e into main Mar 18, 2026
3 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.

Redux example should be context for autodux skill Timing safe compare vulnerabilities should be docs

3 participants