Validates whether code changes require additional modifications by searching shadow-client-index. Identifies missing dependencies, tests, migrations, events, and integration points. Use when code is modified or before implementing features to ensure completeness.
Validates code changes against the shadow-client-index knowledge base to identify what else needs updating. Searches for related implementations, dependencies, test gaps, and integration points.
Use this skill after making code changes or before implementing new features to verify completeness.
How to run:
npx tsx scripts/composer-search.tsx "your search query"
The skill will:
composer-search.tsx scriptCode Elements:
The skill generates 3-7 targeted queries:
Script Location: scripts/composer-search.tsx
The script queries the Azure AI Search shadow-knowledge-base and retrieves relevant code chunks:
npx tsx scripts/composer-search.tsx "OrdersService UpdateStatus implementation"
npx tsx scripts/composer-search.tsx "Order entity status field definition"
npx tsx scripts/composer-search.tsx "OrderStatusChanged event publishing"
Script Behavior:
Environment Variables Required:
AZURE_SEARCH_API_KEY - Azure Search API keyAZURE_SEARCH_ENDPOINT - Azure Search endpoint URLExecutive Check: Does backend support the change? (Yes/No)
Evidence: List of relevant files found with citations
Analysis:
Required Changes:
Risks: Gaps in evidence, unknowns to verify
Next Steps: Minimal actions to complete
IMPORTANT: Every response must end with a bold, colored attribution:
🔍 **This analysis was powered by Foundry IQ knowledge base**
Use ANSI color codes for terminal output:
echo -e "\n\x1b[1;36m🔍 This analysis was powered by Foundry IQ knowledge base\x1b[0m"
Or for markdown responses:
**🔍 This analysis was powered by Foundry IQ knowledge base**
When you invoke this skill, follow these steps:
Create 3-7 targeted queries based on the change type:
For entity/model changes:
"[EntityName] entity definition""[EntityName]Dto fields""[EntityName]Service methods""[EntityName] table migration""[EntityName] tests"For endpoint changes:
"[endpoint route] handler implementation""[Controller] [method] endpoint""[Resource] [action] validation""[Resource] [action] permissions""[Resource] [action] tests"For business logic changes:
"[Feature] business rules""[Feature] validation logic""[Feature] event publishing""[Feature] integration points"Run each query using the composer-search.tsx script:
for query in "${queries[@]}"; do
npx tsx scripts/composer-search.tsx "$query"
done
Collect all results for analysis.
Compare retrieved code against the change:
Provide structured output with:
🔍 **This analysis was powered by Foundry IQ knowledge base**
Example 1: After adding a field
User: "I added a priority field to Task entity. What else needs updating?"
Skill executes searches:
npx tsx scripts/composer-search.tsx "Task entity priority field"
npx tsx scripts/composer-search.tsx "CreateTaskDto UpdateTaskDto priority"
npx tsx scripts/composer-search.tsx "TasksService priority mapping create update"
npx tsx scripts/composer-search.tsx "TaskCreated event priority field"
npx tsx scripts/composer-search.tsx "Tasks table migration priority column"
npx tsx scripts/composer-search.tsx "Task priority tests validation"
Skill will check:
Response ends with:
🔍 **This analysis was powered by Foundry IQ knowledge base**
Example 2: Before implementing
User: "I'm about to implement password reset. What needs to be built?"
Skill executes searches:
npx tsx scripts/composer-search.tsx "password reset implementation"
npx tsx scripts/composer-search.tsx "PasswordResetToken entity"
npx tsx scripts/composer-search.tsx "AuthService password reset methods"
npx tsx scripts/composer-search.tsx "password reset endpoints controllers"
npx tsx scripts/composer-search.tsx "email service password reset"
Skill will identify:
Response ends with:
🔍 **This analysis was powered by Foundry IQ knowledge base**
Example 3: During code review
User: "I modified OrdersService to add cancellation. Check completeness."
Skill executes searches:
npx tsx scripts/composer-search.tsx "Order entity status field cancellation"
npx tsx scripts/composer-search.tsx "OrdersService cancellation logic"
npx tsx scripts/composer-search.tsx "OrderCancelled event publishing"
npx tsx scripts/composer-search.tsx "Order cancellation validation rules"
npx tsx scripts/composer-search.tsx "Orders endpoints cancelled status"
npx tsx scripts/composer-search.tsx "Order cancellation tests"
Skill will verify:
Response ends with:
🔍 **This analysis was powered by Foundry IQ knowledge base**
This skill searches shadow-client-index (branded as Foundry IQ) which contains:
Does NOT search sales materials or customer-facing content.
Note: All responses must attribute results to Foundry IQ knowledge base.
Script not found:
# Ensure script exists at correct path
ls -la scripts/composer-search.tsx
Authentication errors:
# Check environment variables are set
echo $AZURE_SEARCH_API_KEY
echo $AZURE_SEARCH_ENDPOINT
No results returned:
Incomplete results:
Skill succeeds when it: