Topic

Progressive Disclosure

All digests tagged Progressive Disclosure

Agents, codebases, and teams — Aditya Khandelwal, Amazon AGI Lab thumbnail

· 16:57

Agents, codebases, and teams — Aditya Khandelwal, Amazon AGI Lab

The adoption of AI agents in software development is presented as primarily a leadership and organizational challenge, not merely an individual contributor (IC) problem. Successful implementation requires systemic changes—specifically 'harness engineering'—to manage codebase complexity and ensure reliable agent performance across teams. Key strategies include implementing progressive disclosure, establishing high-value skills like 'ship it,' and creating self-healing CI/CD pipelines to mitigate inevitable AI 'slop.'

Key takeaways

  1. Agent Adoption is a Leadership Problem 9:52

    The speaker argues that making engineers work well with agents requires organizational buy-in (leadership action) rather than individual effort. Relying on ICs to restructure the codebase alone will fail, leading to uneven productivity and increased review burden for those who are not early adopters.

  2. Symptoms of a Poor Setup 7:18

    Warning signs that an agent setup is failing include: engineers 'babysitting' agents, the system silently burning context (e.g., blowing through 500k context units), or requiring constant manual intervention for simple tasks.

  3. Harness Engineering Principles 11:49

    Effective agent integration requires three principles: Smart prompt injection (treating the codebase as a single unit to inject context), closing the loop (creating self-healing pipelines to detect and remove 'slop'), and continuous iteration, treating the process like an ongoing organizational improvement effort.

  4. Progressive Disclosure Best Practices 16:57

    To manage context overload, implement strict boundaries. For example, a hard limit of approximately 100 lines is suggested for files like `skill.md` to ensure the agent receives only necessary context in its initial prompt.

Watch on YouTube Full article

We Scored a Real Snyk Skill Against Anthropic's Rules thumbnail

· 15:19

We Scored a Real Snyk Skill Against Anthropic's Rules

This video details a live review process where a Snyk skill (`SKILL.md`) was evaluated using Tessl's `tessl review run` against Anthropic's best practices. The initial score of 87% was successfully improved to 90% by applying fixes, demonstrating how automated tools can enhance skill quality and security. Key focus areas include implementing progressive disclosure to prevent context bloat, improving skill conciseness, and using Snyk's Agent Scan tool to detect vulnerabilities like prompt injection in both first-party and third-party skills.

Key takeaways

  1. Skill Quality Improvement via Automated Review

    The review process successfully increased the skill score from 87% to 90% by applying fixes, demonstrating that automated tools can significantly improve adherence to best practices (e.g., Anthropic's guidelines).

  2. Importance of Progressive Disclosure 10:08

    Skills should not be overly dense or verbose. Implementing progressive disclosure—breaking large skills into smaller, referenced sub-files—prevents context bloat and ensures the agent only loads necessary information.

  3. Security Scanning with Agent Scan

    Snyk's dedicated tool, Agent Scan (available on GitHub), can scan skills for security vulnerabilities, including prompt injection, which is crucial when integrating third-party or user-written skills.

Watch on YouTube Full article