Skip to content

feat(blog): add Model-Driven Approach blog post#730

Open
Unshure wants to merge 4 commits intomainfrom
agent-tasks/725
Open

feat(blog): add Model-Driven Approach blog post#730
Unshure wants to merge 4 commits intomainfrom
agent-tasks/725

Conversation

@Unshure
Copy link
Copy Markdown
Member

@Unshure Unshure commented Apr 2, 2026

Summary

Adds the "Strands Agents and the Model-Driven Approach" blog post by Arron Bailiss to the Strands blog site, backported from AWS Open Source Blog.

Changes

New Blog Post

  • File: src/content/blog/strands-agents-model-driven-approach.mdx
  • Author: arron-bailiss (already exists in authors.yaml)
  • canonicalUrl: Points to original AWS blog

Downloaded Images (6 total)

All images downloaded locally with model-driven- prefix:

  • model-driven-prompt-diagram.png - Agent definition diagram
  • model-driven-agentic-loop.png - Agentic loop diagram
  • model-driven-architecture-1.png through model-driven-architecture-4.png - Production architecture diagrams

Updated Reference

  • File: src/content/blog/steering-accuracy-beats-prompts-workflows.mdx
  • Updated line 16 to reference local blog post instead of external AWS URL

Blog Content Covers

  • Model-driven approach philosophy (letting LLMs drive their own behavior)
  • The agent loop concept (based on ReAct paradigm)
  • Guiding intelligence through context (system prompts, tool specifications, conversation history)
  • Multi-agent patterns: agents-as-tools, swarms, graphs, meta agents
  • Production architectures with diagrams
  • Building confidence through evaluation

Verification

  • Format check passes (npm run format:check)
  • All 6 images downloaded with correct naming
  • Author exists in src/content/authors.yaml
  • Steering blog link updated correctly

Resolves #725

- Add new blog post: strands-agents-model-driven-approach.mdx
- Download 6 images locally with model-driven- prefix
- Update steering blog link to reference local blog post

Resolves #725
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-730/docs/user-guide/quickstart/overview/

Updated at: 2026-04-02T19:42:53.654Z

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Assessment: Request Changes

This is a well-structured blog post backport with properly managed images and correct canonical URL. However, there are a few broken internal links that need to be fixed before merging.

Review Summary
  • Broken Links: Three internal links point to non-existent pages (/user-guide/concepts/agents/agent-configuration/ and /user-guide/concepts/tools/tools-overview/)
  • Content Quality: The blog content is well-written and properly formatted
  • Assets: All 6 images are present with consistent naming convention

Once the links are updated to point to the correct documentation pages, this PR is ready to merge. 🚀

@Unshure
Copy link
Copy Markdown
Member Author

Unshure commented Apr 2, 2026

/strands can we move the images to a resources folder so its better organized?

Also can you read the comments and address the review findings? Seems like there are some broken links

- Create src/content/blog/resources/ directory
- Move all model-driven-*.png images to resources folder
- Update image references in blog post
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Done! Moved all 6 images to src/content/blog/resources/ folder and updated the image references in the blog post accordingly.

- System prompts: /user-guide/concepts/agents/agent-configuration/ → /user-guide/concepts/agents/prompts/
- Tool specifications: /user-guide/concepts/tools/tools-overview/ → /user-guide/concepts/tools/
- Conversation history: /user-guide/concepts/agents/agent-configuration/ → /user-guide/concepts/agents/conversation-management/
- Remove truncated text on last line
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Documentation Preview Failed

The documentation deployment encountered an error. Please check the deployment logs for more details.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

I've identified and prepared the following fixes for the broken internal links. Please apply these changes:

Fixes Required

1. Line 47 - System prompts link:

- **[System prompts](/user-guide/concepts/agents/agent-configuration/)** establish the agent's role...
+ **[System prompts](/user-guide/concepts/agents/prompts/)** establish the agent's role...

2. Line 49 - Tool specifications link:

- **[Tool specifications](/user-guide/concepts/tools/tools-overview/)** define capability boundaries...
+ **[Tool specifications](/user-guide/concepts/tools/)** define capability boundaries...

3. Line 51 - Conversation history link:

- **[Conversation history](/user-guide/concepts/agents/agent-configuration/)** maintains task continuity...
+ **[Conversation history](/user-guide/concepts/agents/conversation-management/)** maintains task continuity...

4. Line 127 - Remove truncated text:
The last line has truncated text n agents. that should be removed.

Once these fixes are applied, the PR should be ready to merge! 🚀

@Unshure
Copy link
Copy Markdown
Member Author

Unshure commented Apr 2, 2026

/strands more failed links

@Unshure
Copy link
Copy Markdown
Member Author

Unshure commented Apr 2, 2026

13:47:14 [ERROR] [astro-broken-links-checker] An unhandled error occurred while running the "astro:build:done" hook
13:47:14 [astro-broken-links-checker] Broken link: /pr-cms-730/user-guide/concepts/agents/agent-loop/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/concepts/agents/agent-configuration/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/concepts/tools/tools-overview/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/concepts/multi-agent/agents-as-tools/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/concepts/multi-agent/swarm/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/concepts/multi-agent/graph/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/deploy/deploy-to-aws-lambda/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/deploy/deploy-to-aws-fargate/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/deploy/deploy-to-amazon-ec2/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/user-guide/observability-evaluation/evaluation/
Found in:
- /blog/strands-agents-model-driven-approach/
Broken link: /pr-cms-730/examples/
Found in:
- /blog/strands-agents-model-driven-approach/
13:47:14 [astro-broken-links-checker] Time to check links: 3066 ms
Broken links detected. Check the log file: broken-links.log
Location:
/home/runner/work/docs/docs/node_modules/astro/dist/integrations/hooks.js:33:12
Stack trace:
at astro:build:done (/home/runner/work/docs/docs/scripts/astro-broken-links-checker-index.js:82:17)
at async runHookInternal (file:///home/runner/work/docs/docs/node_modules/astro/dist/integrations/hooks.js:52:5)
at async AstroBuilder.build (file:///home/runner/work/docs/docs/node_modules/astro/dist/core/build/index.js:168:5)

- Add /docs/ prefix to all user-guide links
- Use underscores for deploy page URLs (deploy_to_aws_lambda, etc.)
- Fix examples link to /docs/examples/
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Fixed all broken internal links:

  • Added /docs/ prefix to all user-guide links
  • Corrected deploy page URLs to use underscores (deploy_to_aws_lambda, deploy_to_aws_fargate, deploy_to_amazon_ec2)
  • Fixed examples link to /docs/examples/

All 11 broken links have been addressed.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Assessment: Approve ✅

All previously identified issues have been resolved:

Verification Summary
  • ✅ All 11 broken internal links fixed with /docs/ prefix
  • ✅ Deploy page URLs corrected to use underscores (deploy_to_aws_lambda, etc.)
  • ✅ Truncated text at end of file removed
  • ✅ Images properly organized in resources/ folder
  • ✅ Format check passes
  • ✅ All linked documentation pages verified to exist

Great work on this blog post backport! 🚀

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.

[NEW CONTENT] Model-Driven approach blog

3 participants