Restructure and improve content organization (#68)

* Restructure and improve content organization

- Add Official Resources section with comprehensive Amp links (Manual, SDK, Chronicle, Status)
- Rename AGENTS.md section to "Agent Files & Context" with better explanation
- Add dedicated MCP Servers section for Model Context Protocol resources
- Reorganize "Built with Amp" into categorized "Projects & Tools" section
- Add Sandboxed.sh - self-hosted cloud orchestrator for AI agents
- Create "Editor & IDE Integrations" section for editor plugins
- Add "Security & Best Practices" section with official security docs
- Simplify CLI Usage section by consolidating examples
- Update TOC to reflect new structure
- Fix contributor link to point to lfglabs-dev repo

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remove broken links (Sink AGENT.md, superpromptor.com)

- Remove Sink AGENT.md link (repo renamed, file no longer exists)
- Remove Unofficial Amp Owner's Manual (superpromptor.com is down)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Update AGENTS.md to reflect new section structure

Update /builtwith command instructions to reference the renamed
"Projects & Tools" section with its subcategories.

Fixes Bugbot review comment.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix repository owner references from jdorfman to lfglabs-dev

Update all internal links to use the current repository owner:
- readme.md: docs link
- AGENTS.md: awesome_bot whitelist
- contributing.md: issues link
- .github/workflows/lint.yaml: awesome_bot whitelist

Fixes Bugbot review comment.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: LFG Labs Maintainer <maintainer@lfglabs.dev>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: 3 people

.github/workflows/lint.yaml

@@ -42,4 +42,4 @@ jobs:
         - name: "install awesome-bot"
           run: gem install awesome_bot
         - name: "linting: ${{ matrix.files }}"
-          run: awesome_bot --allow-redirect --white-list https://github.com/jdorfman/awesome-amp-cli,https://example.com,https://github.com/user-attachments/assets/44099391-3976-473d-bcf8-95fd7b980f99,https://www.npmjs.com/package/llm-rules,https://www.npmjs.com/package/@sourcegraph/amp ${{ matrix.files }} 
+          run: awesome_bot --allow-redirect --white-list https://github.com/lfglabs-dev/awesome-amp-code,https://example.com,https://github.com/user-attachments/assets/44099391-3976-473d-bcf8-95fd7b980f99,https://www.npmjs.com/package/llm-rules,https://www.npmjs.com/package/@sourcegraph/amp ${{ matrix.files }} 

AGENTS.md

@@ -3,7 +3,7 @@
 ## Build, Lint & Test Commands
 
 - Lint readme: `npx awesome-lint readme.md`
-- Link check: `awesome_bot --allow-redirect --white-list https://github.com/jdorfman/awesome-amp-code,https://example.com readme.md`
+- Link check: `awesome_bot --allow-redirect --white-list https://github.com/lfglabs-dev/awesome-amp-code,https://example.com readme.md`
 - Node.js version: Use v21.6.0 (as specified in .tool-versions)
 
 ## Code Style Guidelines
@@ -21,9 +21,9 @@
 - Main content is in amp_cli_docs.md and readme.md
 - CI pipeline uses awesome-lint and awesome_bot to validate content
 
-## Add link to Built With section
+## Add link to Projects & Tools section
 
-When `/builtwith` followed by a link is included in a prompt, you will add the link to the Built With section of the README.md file. If there is a numbered list of urls, create subagents to complete the tasks.
+When `/builtwith` followed by a link is included in a prompt, you will add the link to the "Projects & Tools" section of the README.md file under the appropriate subcategory (Documentation & Guides, Development Tools, Applications Built with Amp, or Browser & Misc). If there is a numbered list of urls, create subagents to complete the tasks.
 
 ## Add link to @docs/amp_faq.md
 

contributing.md

@@ -8,7 +8,7 @@ ALWAYS create a new branch with your proposed changes. Thank you!
 
 ## Adding an new Item
 
-- Try to fit your item into an existing sections. [Open a suggestion](https://github.com/jdorfman/awesome-amp-code/issues/new) to start as discussion about any new sections.
+- Try to fit your item into an existing sections. [Open a suggestion](https://github.com/lfglabs-dev/awesome-amp-code/issues/new) to start as discussion about any new sections.
 - Add a new item to the bottom of the list in a section.
 - If a duplicate item exists, discuss why the new item should replace it.
 - Check your spelling & grammar.

readme.md

@@ -27,114 +27,135 @@ An **unofficial** curated list of resources for Amp, an AI coding agent by Sourc
 
 ## Contents
 
-- [Awesome Amp Code](#awesome-amp-code)
-  - [Contents](#contents)
-    - [AGENTS.md](#agentsmd)
-    - [Built with Amp](#built-with-amp)
-    - [Amp Integrations](#amp-integrations)
-    - [Amp CLI](#amp-cli)
-      - [Integration with Common CLI Tools](#integration-with-common-cli-tools)
-        - [ps aux](#ps-aux)
-        - [whois](#whois)
-        - [curl](#curl)
-        - [npm](#npm)
-    - [Official Amp Links](#official-amp-links)
-    - [Contributing](#contributing)
-      - [Contributors](#contributors)
+- [Official Resources](#official-resources)
+- [Agent Files & Context](#agent-files--context)
+- [MCP Servers](#mcp-servers)
+- [Projects & Tools](#projects--tools)
+- [Editor & IDE Integrations](#editor--ide-integrations)
+- [CLI Usage](#cli-usage)
+- [Security & Best Practices](#security--best-practices)
+- [Contributing](#contributing)
 
 <!-- CONTENT -->
 
-### AGENTS.md
+### Official Resources
 
-- [LangGraph](https://sourcegraph.com/github.com/langchain-ai/langgraph/-/blob/AGENTS.md)
-- [Sink](https://sourcegraph.com/github.com/ccbikai/Sink/-/blob/AGENT.md)
-- [Zoekt](https://sourcegraph.com/github.com/sourcegraph/zoekt/-/blob/AGENT.md)
-- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client/blob/main/AGENT.md)
-- [MCP Advisor](https://sourcegraph.com/github.com/istarwyh/mcpadvisor/-/blob/AGENT.md)
-- [Use MCP](https://sourcegraph.com/github.com/modelcontextprotocol/use-mcp/-/blob/AGENT.md)
+- [Amp](https://ampcode.com) - Main Amp website.
+- [Amp Owner's Manual](https://ampcode.com/manual) - Comprehensive official documentation covering installation, usage, and best practices.
+- [Amp CLI](https://www.npmjs.com/package/@sourcegraph/amp) - Official CLI package on npm.
+- [Amp for VS Code](https://marketplace.visualstudio.com/items?itemName=sourcegraph.amp) - Official VS Code extension.
+- [Amp SDK](https://ampcode.com/manual/sdk) - Official SDK documentation for building on Amp.
+- [Raising an Agent Podcast](https://ampcode.com/podcast) - Podcast featuring insights from the Amp team.
+- [Amp 101 YouTube Playlist](https://www.youtube.com/playlist?list=PL6zLuuRVa1_hLpciEULtzC3g3u4NJ6TVz) - Official video tutorials.
+- [How to Build an Agent](https://ampcode.com/how-to-build-an-agent) - Guide to building AI agents.
+- [Amp Chronicle](https://ampcode.com/chronicle) - Official news and announcements.
+- [Amp Status](https://ampcodestatus.com) - Service status page.
+- [Amp on X](https://x.com/ampcode) - Official Twitter/X account.
 
-### Built with Amp
+### Agent Files & Context
 
-- [Unofficial Amp CLI Documentation](https://github.com/jdorfman/awesome-amp-code/blob/main/docs/amp_cli_docs.md) - Comprehensive documentation for Amp CLI with examples and best practices.
-- [MyScratchpad VS Code Extension](https://marketplace.visualstudio.com/items?itemName=jccoder.myscratchpad) - VS Code extension for global and workspace-specific scratch files.
+AGENTS.md files provide context and instructions to AI coding agents about your codebase. They help agents understand project structure, coding standards, and specific requirements.
+
+**Examples of AGENTS.md in open source projects:**
+
+- [LangGraph](https://sourcegraph.com/github.com/langchain-ai/langgraph/-/blob/AGENTS.md) - LangChain's graph-based agent framework.
+- [Zoekt](https://sourcegraph.com/github.com/sourcegraph/zoekt/-/blob/AGENT.md) - Fast code search by Sourcegraph.
+- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client/blob/main/AGENT.md) - Comprehensive MCP client implementation.
+- [MCP Advisor](https://sourcegraph.com/github.com/istarwyh/mcpadvisor/-/blob/AGENT.md) - MCP server advisor tool.
+- [Use MCP](https://sourcegraph.com/github.com/modelcontextprotocol/use-mcp/-/blob/AGENT.md) - Official MCP usage examples.
+
+### MCP Servers
+
+Model Context Protocol (MCP) enables AI agents to interact with external tools and services. These MCP servers extend Amp's capabilities:
+
+- [llm-rules MCP](https://www.npmjs.com/package/llm-rules) - Access Cursor rules dynamically via MCP.
+- [CleanShot MCP](https://github.com/jdorfman/cleanshot-mcp) - MCP server for CleanShot X screenshot and recording integration.
+- [MCP Advisor](https://github.com/istarwyh/mcpadvisor) - Tool to help discover and configure MCP servers.
+- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client) - Comprehensive MCP client for testing and debugging servers.
+- [Use MCP](https://github.com/modelcontextprotocol/use-mcp) - Official examples and utilities for MCP usage.
+
+### Projects & Tools
+
+**Documentation & Guides:**
+
+- [Unofficial Amp CLI Documentation](https://github.com/lfglabs-dev/awesome-amp-code/blob/main/docs/amp_cli_docs.md) - Comprehensive documentation for Amp CLI with examples and best practices.
+- [File-Based Amp Prompting Workflows](https://github.com/PriNova/amp-prompting-workflows) - Collection of file-based sub-agent orchestration workflows for Amp.
+
+**Development Tools:**
+
+- [Sandboxed.sh](https://github.com/Th0rgal/sandboxed.sh) - Self-hosted cloud orchestrator for AI coding agents with isolated Linux environments.
 - [Unofficial Amp Supervisor](https://github.com/ctrl-cheeb-del/manager) - TUI control panel for managing multiple Amp CLI instances in parallel.
-- [llm-rules MCP](https://www.npmjs.com/package/llm-rules) - Model Context Protocol server for accessing Cursor rules dynamically.
-- [amp.el](https://github.com/shaneikennedy/amp.el) - Emacs integration for Amp coding agent.
-- [Remote Code](https://remote-code.com/) - Mobile coding platform that brings AI coding agents to your iPhone.
-- [Sourcegraph Amp AUR](https://github.com/AnirudhKonduru/sourcegraph-amp-aur) - Arch Linux AUR package for Sourcegraph Amp.
-- [PromptVault](https://hex.pm/packages/prompt_vault) - A library for managing prompts and templates in Elixir. [Watch stream](https://www.youtube.com/live/ojaoe3h8hXA?feature=share).
-- [Unofficial Amp Owner's Manual](https://superpromptor.com/amp-owners-manual/) - Comprehensive guide to getting the most out of Amp coding agent.
-- [Sourcegraph Chrome Extension](https://chromewebstore.google.com/detail/sourcegraph/dgjhfomjieaadpoljlnidmbg) - Chrome extension for code search and navigation.
-- [CircuitPython Deploy](https://github.com/shantanugoel/circuitpython-deploy) - CircuitPython deployment tool.
-- [File-Based Amp Prompting Workflows](https://github.com/PriNova/amp-prompting-workflows) - Comprehensive collection of file-based sub-agent orchestration workflows for Amp with persistent document-based communication.
+- [Conductor](https://x.com/charliebholtz/status/1963345520543633742) - Run a bunch of Amps in parallel.
 - [Amp Code Review CI](https://github.com/madhukarkumar/amp-code-review-ci) - Continuous integration tool for automated code reviews using Amp.
+- [Tokscale](https://github.com/junhoyeo/tokscale) - CLI tool for tracking token usage from AmpCode and other coding agents.
+- [Sniff](https://github.com/conikeec/sniff) - Misalignment detection in Vibe Coding loops.
 - [CodeForge](https://github.com/entrepeneur4lyf/CodeForge) - Golang Development tool built with Amp.
-- [Quad Ops](https://trly.github.io/quad-ops/) - A lightweight GitOps framework for podman containers managed by Quadlet.
-- [HTTPie Collection Viewer](https://httpie.bolaji.de/) - Upload and explore your HTTPie collections with style.
-- [CleanShot MCP](https://github.com/jdorfman/cleanshot-mcp) - Model Context Protocol server for CleanShot X screenshot and recording.
-- [SageMap](https://sagemap.netlify.app/) - Interactive belief mapping tool that transforms journal entries into visual networks revealing contradictions and connections in your thoughts.
+
+**Applications Built with Amp:**
+
 - [Jazzberry AI](https://jazzberry.ai/) - The AI Bug Finder.
-- [0.email](https://0.email/) - Zero is an AI-native email client that manages your inbox.
-- [VT Chat](https://vtchat.io.vn/) - A minimal, privacy-first AI chat application with advanced AI capabilities.
-- [Sniff](https://github.com/conikeec/sniff) - Misalignment detection in Vibe Coding loops.
+- [0.email](https://0.email/) - AI-native email client that manages your inbox.
+- [Remote Code](https://remote-code.com/) - Mobile coding platform that brings AI coding agents to your iPhone.
+- [SageMap](https://sagemap.netlify.app/) - Interactive belief mapping tool for journal entries.
+- [VT Chat](https://vtchat.io.vn/) - Privacy-first AI chat application.
+- [HTTPie Collection Viewer](https://httpie.bolaji.de/) - Upload and explore your HTTPie collections.
+- [Quad Ops](https://trly.github.io/quad-ops/) - Lightweight GitOps framework for podman containers.
+- [PromptVault](https://hex.pm/packages/prompt_vault) - Library for managing prompts and templates in Elixir.
+- [CircuitPython Deploy](https://github.com/shantanugoel/circuitpython-deploy) - CircuitPython deployment tool.
 
-### Amp Integrations
+**Browser & Misc:**
+
+- [Sourcegraph Chrome Extension](https://chromewebstore.google.com/detail/sourcegraph/dgjhfomjieaadpoljlnidmbg) - Chrome extension for code search and navigation.
+- [Sourcegraph Amp AUR](https://github.com/AnirudhKonduru/sourcegraph-amp-aur) - Arch Linux AUR package for Sourcegraph Amp.
+
+### Editor & IDE Integrations
 
-- [Amp Dash X](https://www.raycast.com/jdorfman/sourcegraph-amp-dash-x) - A Raycast extension for organizing and executing Amp Code prompts with the `-x` (execute) flag.
-- [VibeKanban](https://www.vibekanban.com/) - CLI tool for managing your Kanban boards.
-- [Conductor](https://x.com/charliebholtz/status/1963345520543633742) - Run a bunch of Amps in parallel.
 - [amp.nvim](https://github.com/sourcegraph/amp.nvim) - Official Neovim plugin for Amp coding agent.
 - [nvim-amp](https://github.com/aliou/nvim-amp) - Neovim plugin providing syntax highlighting and support for Amp permission and agent files.
+- [amp.el](https://github.com/shaneikennedy/amp.el) - Emacs integration for Amp coding agent.
 - [Amp ACP](https://github.com/tao12345666333/amp-acp) - ACP adapter for Amp Code, enabling Amp to work in the Zed editor.
-- [Tokscale](https://github.com/junhoyeo/tokscale) - A CLI tool for tracking token usage from AmpCode and other coding agents (OpenCode, Claude Code, Codex, Gemini CLI, Cursor IDE, and Factory Droid)
-
-### Amp CLI
-
-#### Integration with Common CLI Tools
+- [MyScratchpad VS Code Extension](https://marketplace.visualstudio.com/items?itemName=jccoder.myscratchpad) - VS Code extension for global and workspace-specific scratch files.
+- [Amp Dash X](https://www.raycast.com/jdorfman/sourcegraph-amp-dash-x) - Raycast extension for organizing and executing Amp Code prompts.
+- [VibeKanban](https://www.vibekanban.com/) - CLI tool for managing your Kanban boards.
 
-Amp CLI can be seamlessly integrated with other command-line tools to enhance your workflow. Use the `-x` flag for execute mode or pipe input directly:
+### CLI Usage
 
-##### ps aux
+Amp CLI can be integrated with other command-line tools. Use the `-x` flag for execute mode or pipe input directly:
 
 ```bash
+# Analyze processes
 ps aux > processes.txt | amp -x 'identify processes consuming the most resources in processes.txt'
-```
-
-##### whois
 
-```bash
+# Parse whois data
 whois example.com | amp -x 'organize and condense this whois information'
-```
-
-##### curl
 
-```bash
+# Analyze HTTP headers
 curl -Is https://github.com > headers.txt && amp -x 'analyze the http headers in headers.txt and determine the tech stack'
-```
-
-##### npm
 
-```bash
+# Check npm dependencies
 npm list --json | amp -x 'identify outdated or vulnerable dependencies'
 ```
 
-### Official Amp Links
+### Security & Best Practices
+
+When using AI coding agents, consider these security aspects:
+
+- [Amp Security Reference](https://ampcode.com/security) - Official security documentation and guidelines.
+- [Amp Permissions](https://ampcode.com/manual/permissions) - Control what actions the agent can perform.
 
-- [Amp](https://ampcode.com)
-- [Amp CLI](https://www.npmjs.com/package/@sourcegraph/amp)
-- [Amp for VS Code](https://marketplace.visualstudio.com/items?itemName=sourcegraph.amp)
-- [Raising an Agent Podcast](https://ampcode.com/podcast)
-- [Amp on X](https://x.com/ampcode)
-- [How to Build an Agent](https://ampcode.com/how-to-build-an-agent)
-- [Amp 101 YouTube Playlist](https://www.youtube.com/playlist?list=PL6zLuuRVa1_hLpciEULtzC3g3u4NJ6TVz)
+**Key recommendations:**
+- Always review AI-generated code before committing
+- Never include API keys or secrets in prompts or AGENTS.md files
+- Consider running agents in isolated environments for sensitive projects
+- Vet MCP servers before installation
 
 ### Contributing
 
 [Contributions of any kind welcome, just follow the guidelines](contributing.md)!
 
 #### Contributors
 
-[Thanks goes to these contributors](https://github.com/jdorfman/awesome-amp-code/graphs/contributors)!
+[Thanks goes to these contributors](https://github.com/lfglabs-dev/awesome-amp-code/graphs/contributors)!
 
 ---