chore: improve docs

.gitignore

@@ -36,3 +36,7 @@ report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
 # Finder (MacOS) folder config
 .DS_Store
 .cursor/plugins.local.json
+
+# TrogonAI internal files
+.trogonai/
+*.internal.trogonai.md

README.md

@@ -57,12 +57,12 @@ If you have Claude Code installed, **AIPM automatically discovers its marketplac
 aipm list
 
 📦 Marketplaces:
-  • claude:anthropic-agent-skills (🤖 Claude Code auto-discovered)
-  • claude:claude-code-workflows (🤖 Claude Code auto-discovered)
+  • claude/anthropic-agent-skills (🤖 Claude Code auto-discovered)
+  • claude/claude-code-workflows (🤖 Claude Code auto-discovered)
 
 # Install Claude Code plugins to Cursor
-aipm plugin install algorithmic-art@claude:anthropic-agent-skills
-aipm plugin install document-skills/docx@claude:anthropic-agent-skills
+aipm plugin install algorithmic-art@claude/anthropic-agent-skills
+aipm plugin install document-skills/docx@claude/anthropic-agent-skills
 aipm sync  # Installs to .cursor/ for Cursor to use
 ```
 

docs/README.md

@@ -37,7 +37,7 @@ _Technical specifications and API details_
 
 **New to aipm?** Start here:
 
-1. **Install**: Follow the [Installation Guide](../INSTALLATION.md)
+1. **Install**: Follow the [Installation Guide](./how-to/installation.md)
 2. **Learn**: Complete the [Getting Started Tutorial](./tutorials/getting-started.md)
 3. **Use**: Browse [How-To Guides](./how-to/) for your specific task
 
@@ -67,7 +67,7 @@ Consult [Reference](./reference/)
 
 ### For Users
 
-- [Installation Guide](../INSTALLATION.md) - Platform-specific installation
+- [Installation Guide](./how-to/installation.md) - Platform-specific installation
 - [README](../README.md) - Project overview and quick start
 - [Changelog](../CHANGELOG.md) - Version history
 

docs/explanation/architecture.md

@@ -130,11 +130,3 @@ graph LR
 | New command          | Create `src/commands/my-command.ts`, register in `cli.ts`     |
 | New marketplace type | Add to `MarketplaceSource`, update `resolveMarketplacePath()` |
 | New sync strategy    | Implement in `sync-strategy.ts`, add config option            |
-
----
-
-## Related
-
-- [Configuration System](./config-system.md)
-- [Git Cache Strategy](./git-cache.md)
-- [Plugin Lifecycle](./plugin-lifecycle.md)

docs/how-to/configure-aipm.md

@@ -245,5 +245,3 @@ aipm marketplace add team git@github.com:owner/repo.git
 
 - [Tutorial: Getting Started](../tutorials/getting-started.md) - Learn aipm basics
 - [How-to: Create a Marketplace](./create-marketplace.md) - Build your own plugin marketplace
-- [Reference: Configuration](../reference/configuration.md) - Full config file reference
-- [Explanation: Configuration System](../explanation/configuration-system.md) - Understand how config merging works

docs/how-to/create-marketplace.md

@@ -227,8 +227,6 @@ my-team-plugins/
 ??? README.md
 ```
 
-See [Working with Monorepos](./monorepo-marketplace.md) for details.
-
 ---
 
 ## Troubleshooting
@@ -252,11 +250,3 @@ Team members must update:
 ```bash
 aipm marketplace update acme-eng
 ```
-
----
-
-## Related
-
-- [Tutorial: Team Marketplace Setup](../tutorials/team-marketplace.md)
-- [Explanation: Marketplace Types](../explanation/marketplace-types.md)
-- [Reference: Marketplace Schema](../reference/marketplace-manifest.md)

docs/how-to/debug-plugins.md

@@ -386,5 +386,3 @@ If you're still stuck:
 ## Related
 
 - [Reference: CLI Commands](../reference/cli-commands.md)
-- [Reference: Exit Codes](../reference/exit-codes.md)
-- [Explanation: Git Cache Strategy](../explanation/git-cache.md)

docs/reference/cli-commands.md

@@ -592,18 +592,9 @@ All commands use these exit codes:
 | `0`  | Success                               |
 | `1`  | Error (see error message for details) |
 
-For detailed error information, see [Exit Codes Reference](./exit-codes.md).
-
----
-
-## Environment Variables
-
-See [Environment Variables Reference](./environment.md).
-
 ---
 
 ## Related
 
 - [How-To: Debug Plugins](../how-to/debug-plugins.md)
 - [Tutorial: Getting Started](../tutorials/getting-started.md)
-- [Configuration Schema](./config-schema.md)

docs/tutorials/first-plugin.md

@@ -269,7 +269,6 @@ Now that you understand the basics, try:
 
 Continue to:
 
-- [Team Marketplace Tutorial](./team-marketplace.md) - Share with your team
 - [How to Create a Marketplace](../how-to/create-marketplace.md) - Advanced marketplace setup
 
 ---

docs/tutorials/getting-started.md

@@ -100,7 +100,7 @@ Enable your plugin and sync it:
 # Enable the hello-world plugin
 aipm plugin enable hello-world@my-marketplace
 
-# Sync plugins to .cursor/marketplace/
+# Sync plugins to .cursor/{type}/aipm/
 aipm sync
 
 # List all plugins
@@ -115,14 +115,14 @@ aipm info hello-world@my-marketplace
 Check that the plugin files were synced correctly:
 
 ```bash
-# List synced plugin files
-ls -la .cursor/marketplace/my-marketplace/hello-world/
+# List synced plugin files (commands are in commands/, rules in rules/, etc.)
+ls -la .cursor/commands/aipm/my-marketplace/hello-world/
 
 # View the command file
-cat .cursor/marketplace/my-marketplace/hello-world/commands/greet.md
+cat .cursor/commands/aipm/my-marketplace/hello-world/greet.md
 ```
 
-You should see your plugin's command file in the marketplace directory!
+You should see your plugin's command file in the commands directory!
 
 ## Part 6: Managing Plugins
 
@@ -163,11 +163,11 @@ If you have Claude Code installed with official Anthropic marketplaces, **AIPM a
 ```bash
 # No configuration needed - Claude Code marketplaces are auto-discovered!
 aipm list
-# Shows: claude:anthropic-agent-skills (auto-discovered from Claude Code)
+# Shows: claude/anthropic-agent-skills (auto-discovered from Claude Code)
 
 # Install Claude Code plugins to Cursor
-aipm plugin install algorithmic-art@claude:anthropic-agent-skills
-aipm plugin install document-skills/docx@claude:anthropic-agent-skills  # nested plugin!
+aipm plugin install algorithmic-art@claude/anthropic-agent-skills
+aipm plugin install document-skills/docx@claude/anthropic-agent-skills  # nested plugin!
 
 # Sync to .cursor/ directory (for Cursor to use)
 aipm sync