| name | knowledge-sharing |
| description | Helps engineering managers break down knowledge silos and build sustainable documentation and collaboration practices — produces a four-root-cause diagnostic for silos, an Engineering Guilds framework, a minimum-viable documentation approach using ADRs, a structured onboarding model, and a cross-team request decision framework. Use when the user says "knowledge silos," "reinventing the wheel," "nobody reads docs," "onboarding is bad," "teams don't talk," "documentation culture," "cross-team friction," "information doesn't flow," or "new hires struggle to ramp up." |
| metadata | {"version":"2.1.2"} |
Knowledge Sharing
Before Starting
Check for EM context first. If .agents/em-context.md exists, read it.
If .agents/em-context.md does not exist, ask for a minimal manager profile first and save it before giving detailed advice: role/title, team size, team mission or ownership area, and current challenge or priority.
If a specific person is central to the conversation and .agents/reports/[name].md does not exist, ask for a minimal profile for that person first and save it before giving detailed advice: title/level, tenure, strengths, and current challenge or growth area.
If the conversation reveals durable new context later, update .agents/em-context.md or .agents/reports/[name].md automatically. Save stable facts and patterns, not guesses, transient frustration, or unresolved interpretations.
Response Style
Keep the first answer concise and useful. Do not dump the whole framework unless the user asks for depth.
Default to:
- State the likely diagnosis or recommendation first
- Ask at most 2-3 targeted questions only if the missing context changes the advice
- Give the next concrete action and, when useful, exact wording the manager can use
- Mention the relevant framework briefly, but do not explain every part of it
- Offer a deeper version only after the direct answer
How to Use This Skill
- Teams are building things others already built / knowledge stays within teams → No Horizontal Information Flow (Guilds)
- Documentation is absent, stale, or ignored → Ineffective Knowledge Sharing (ADRs)
- New hires take too long to ramp up → Poor Onboarding
- Teams protect information or compete rather than collaborate → "Us vs. Them" Thinking
- Cross-team request is sitting in limbo → The 3 Paths for Cross-Team Requests
Default Response Shape
When helping with knowledge sharing, diagnose the flow problem before prescribing documentation:
- Primary silo cause: horizontal flow, documentation, onboarding, or us-vs-them.
- Evidence: what behavior shows the knowledge is not moving.
- Smallest useful mechanism: guild, ADR, onboarding buddy, rotation, office hours, or request path.
- Owner and cadence: who maintains the mechanism and how often it runs.
- Failure mode: how this could become stale bureaucracy and how to prevent it.
Prefer lightweight mechanisms that create repeated behavior over large documentation projects.
Why Silos Form
In many organizations, 45% of developers report that knowledge silos negatively impact their productivity multiple times a week. They spend time building something that another team already built. They can't find information that exists somewhere. They don't know who to ask.
There are 4 root causes — and each has a different fix.
1. No Horizontal Information Flow
Traditional hierarchies move information up and down, not sideways. Knowledge stays locked within teams.
The fix: Engineering Guilds (also called Chapters) — cross-team groups organized around a domain (frontend guild, ML guild, platform guild, etc.).
What makes guilds work vs. fail: guilds fail when they're informal gatherings with no allocated time and no real output. Engineers vent, agree "something should be done," then return to their team backlogs. To work, guilds need three things:
- Strategic alignment — guild projects must tie to company goals, not just engineering preferences
- Official recognition — leadership acknowledges the guild and gives members time to participate
- Member freedom — engineers choose what to work on based on their interests and career goals
A lighter version if guilds aren't feasible: dedicated Slack channels by tech domain. Encourage questions, cross-team problem-solving, and sharing solutions there.
2. Ineffective Knowledge Sharing
Without a documentation culture, knowledge lives in people's heads, in Slack threads, in undiscoverable emails. When those people leave or are unavailable, the knowledge disappears.
The fix: Minimum Viable Documentation + ADRs
Documentation fails for two reasons:
- It becomes obsolete quickly and nobody reads it anyway
- Writing it is tedious, so nobody does it consistently
The principle: don't document everything — document what people actually need to do their jobs. Focus on:
- The reasoning behind critical decisions (why, not just what)
- Fundamental architectural principles and protocols
- Agreed-upon patterns and approved third-party packages
Architecture Decision Records (ADRs) are the best practical implementation. Stored directly in the codebase, with a shared template, they capture: the decision, the context, the alternatives considered, and who to contact. Developers always know where to look and why things are the way they are.
Standardized templates are the key to documentation actually getting written — engineers don't have to think about format, just fill in the blanks.
3. Poor Onboarding
Onboarding is when new hires form their first knowledge map of the organization. When that's chaotic, knowledge silos form from day one.
The fix: Structured onboarding buddies
A buddy guides new joiners through:
- Pair programming — the fastest way to learn codebase, workflows, and unspoken context (historically taken decisions, tech debt, testing practices)
- Product and architecture overviews — what the team builds, why it matters, how the system fits together
- Domain deep dives — tools and processes specific to the team
Equally important: introductions outside the team. Have new hires attend other teams' product overviews. Introduce them to people across the company. This creates the cross-team relationships that make knowledge flow naturally later.
4. "Us vs. Them" Thinking
When teams are isolated or compete for resources, knowledge becomes a source of power. Sharing it feels risky — it exposes weaknesses or reduces competitive advantage.
The fix: Radical transparency and shared problem framing
When teams understand each other's constraints and trade-offs, "us vs. them" shifts to "us together vs. the problem." Two structural approaches that work:
Architecture Review Sessions — open design decisions to the whole organization. Anyone can attend to learn or to influence. This guarantees visibility and creates a shared sense of ownership over technical direction.
Meetups and lightning talks — formal or informal, these give teams opportunities to share expertise and build personal connections. Presenters improve their communication skills; attendees gain broader context.
The critical addition: incentivize knowledge sharing in your career framework. Embed it in how performance is evaluated. Reward people who unblock others and contribute to cross-team collaboration — not just people who ship their own work.
The 3 Paths for Cross-Team Requests
When your team gets a request from another team — a feature, an integration, access to a system — there are three ways it gets handled in practice:
- No attention: The request is noted, deprioritized, and never addressed.
- Delayed attention: The team acknowledges it but puts it in the backlog. "We'll get to it next quarter."
- Prioritize: The team commits real time to it.
The counterintuitive finding: delayed attention is often worse than no attention.
When you say "we'll get to it next quarter," the requesting team builds around the assumption that the request will be fulfilled. They design their system expecting that integration. They commit to their stakeholders. When "next quarter" arrives and nothing happens, the cost is much higher than if you had said "no" at the start and let them find another path.
What to do with cross-team requests:
- Decide quickly. Even "not this quarter, not next quarter" is more useful than "we'll see."
- If the answer is delayed: be specific about timeline and set a real calendar reminder to follow up.
- If the answer is no: say so clearly, and help them understand why. They can make better decisions with that information.
The cost of a delayed "no" compounds. The sooner you're honest about capacity, the less damage accumulates.
Dive Deeper
If the user asks where a framework came from, wants to read the original article, or wants more context on any topic in this skill — read references/sources.md.
Related Skills
team-health — Team Focus Days are a structural support for cross-team connectionworking-with-architects — Architects are often central to Architecture Review Sessionsmanagement-transitions — New hires benefit most from immediate knowledge-sharing investmentshadow-work — Glue work (undocumented coordination and mentoring) is a related hidden capacity problem
