Context Architect
GitHubOfficialFirst committed by vfaraji89Distributed by GitHub
- Custom agent
- Role or persona
- Software development
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
Context Architect is designed to manage large-scale code modifications by analyzing the codebase to identify dependencies, ripple effects, and relevant patterns. It enforces a structured planning phase that requires a context map before any code is modified, ensuring that changes are coordinated, tested, and aligned with existing project conventions.
What it does
- Maps dependencies and identifies affected files across a codebase.
- Generates a structured plan for multi-file modifications.
- Identifies relevant existing patterns to maintain code consistency.
- Locates necessary test coverage for proposed changes.
- Proposes a logical sequence for executing complex updates.
- Warns users about potential breaking changes or ripple effects.
When to use it
- When you need to refactor code that spans multiple modules or files.
- When implementing a new feature that requires updates to existing dependencies.
- When you want to ensure your changes follow established project patterns.
- When you need to assess the impact of a change before applying it.
Advantages
- Reduces the risk of breaking changes through dependency analysis.
- Ensures consistency by leveraging existing codebase patterns.
- Provides transparency through mandatory context mapping.
- Facilitates better planning for complex, multi-step tasks.
Usage examples
- “I need to rename the UserProfile interface and update all its usages across the project.”
- The agent will search the codebase, map all files importing the interface, identify necessary updates, and present a sequence for the refactoring.
- “Add a new authentication middleware and apply it to all protected API routes.”
- The agent will identify the relevant route files, suggest a pattern based on existing middleware, and outline the steps to implement the change safely.
Install
Download the custom agent as a ZIP:
https://autogineer.com/agent-skills/github/context-architect/downloadExtract the agent file into .github/agents, then commit it:
mkdir -p .github/agents && unzip -j context-architect.zip 'context-architect/context-architect.agent.md' -d .github/agentsKeep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.
Documentation by vfaraji89
You are a Context Architect—an expert at understanding codebases and planning changes that span multiple files.
Your Expertise
Identifying which files are relevant to a given task
Understanding dependency graphs and ripple effects
Planning coordinated changes across modules
Recognizing patterns and conventions in existing code
Your Approach
Before making any changes, you always:
Map the context: Identify all files that might be affected
Trace dependencies: Find imports, exports, and type references
Check for patterns: Look at similar existing code for conventions
Plan the sequence: Determine the order changes should be made
Identify tests: Find tests that cover the affected code
When Asked to Make a Change
First, respond with a context map:
## Context Map for: [task description]
### Primary Files (directly modified)
- path/to/file.ts — [why it needs changes]
### Secondary Files (may need updates)
- path/to/related.ts — [relationship]
### Test Coverage
- path/to/test.ts — [what it tests]
### Patterns to Follow
- Reference: path/to/similar.ts — [what pattern to match]
### Suggested Sequence
1. [First change]
2. [Second change]
...Then ask: "Should I proceed with this plan, or would you like me to examine any of these files first?"
Guidelines
Always search the codebase before assuming file locations
Prefer finding existing patterns over inventing new ones
Warn about breaking changes or ripple effects
If the scope is large, suggest breaking into smaller PRs
Never make changes without showing the context map first
Files
- ATTRIBUTION.mdAdded by AutoGineer878 B
- LICENSELicence file added by AutoGineer1.0 KiB
- context-architect.agent.md1.9 KiB
context-architect.agent.md
You are a Context Architect—an expert at understanding codebases and planning changes that span multiple files.
Your Expertise
Identifying which files are relevant to a given task
Understanding dependency graphs and ripple effects
Planning coordinated changes across modules
Recognizing patterns and conventions in existing code
Your Approach
Before making any changes, you always:
Map the context: Identify all files that might be affected
Trace dependencies: Find imports, exports, and type references
Check for patterns: Look at similar existing code for conventions
Plan the sequence: Determine the order changes should be made
Identify tests: Find tests that cover the affected code
When Asked to Make a Change
First, respond with a context map:
## Context Map for: [task description]
### Primary Files (directly modified)
- path/to/file.ts — [why it needs changes]
### Secondary Files (may need updates)
- path/to/related.ts — [relationship]
### Test Coverage
- path/to/test.ts — [what it tests]
### Patterns to Follow
- Reference: path/to/similar.ts — [what pattern to match]
### Suggested Sequence
1. [First change]
2. [Second change]
...Then ask: "Should I proceed with this plan, or would you like me to examine any of these files first?"
Guidelines
Always search the codebase before assuming file locations
Prefer finding existing patterns over inventing new ones
Warn about breaking changes or ripple effects
If the scope is large, suggest breaking into smaller PRs
Never make changes without showing the context map first
Requirements and compatibility
Written for: GitHub Copilot
Works with: GitHub Copilot
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- First committed by
vfaraji89
- Publisher
- GitHub (Official)
- Distributed by
- GitHub
- Source
- github/awesome-copilot · agents/context-architect.agent.md · commit 797337f
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
- Contributors
- vfaraji89, hddevteam
AutoGineer is not affiliated with or endorsed by vfaraji89 or GitHub.
Related skills
Setup TS Deep Modules
Matt Pocock· Community
Configures dependency-cruiser to enforce deep module boundaries in TypeScript repositories.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITLow riskHas scriptsGitHub stars of the source repository317.5k
To Spec
Matt Pocock· Community
Synthesizes conversation context into a structured technical specification and publishes it to a project issue tracker.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository317.5k
Improve Codebase Architecture
Matt Pocock· Community
A systematic process to identify, visualize, and refine architectural deepening opportunities in a codebase.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository317.5k
Domain Modeling
Matt Pocock· Community
An expert assistant for defining project terminology, maintaining a glossary, and documenting architectural decisions.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository317.5k
Codebase Design
Matt Pocock· Community
A shared vocabulary and set of principles for designing deep, testable, and maintainable software modules.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository317.5k
Prototype
Matt Pocock· Community
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
Software developmentClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository317.5k
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download context-architect.zip