plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6968be85e40c819191f4e29151efa7d1",
  "version": "1.3.0",
  "description": "DocuWriter is an AI-powered platform for creating, updating and managing complete, structured documentation for entire codebases. Teams can connect repositories and generate documentation covering architecture, modules, services, classes, functions, dependencies, APIs, diagrams, READMEs, and other technical components. It supports both individual repositories and larger multi-repository systems.",
  "author": {
    "name": "DocuWriter.ai",
    "url": "https://www.docuwriter.ai/"
  },
  "homepage": "https://www.docuwriter.ai/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "DocuWriter.ai",
        "shortDescription": "Generate and maintain docs",
        "longDescription": "DocuWriter is an AI-powered platform for creating, updating and managing complete, structured documentation for entire codebases. Teams can connect repositories and generate documentation covering architecture, modules, services, classes, functions, dependencies, APIs, diagrams, READMEs, and other technical components. It supports both individual repositories and larger multi-repository systems.\n\nIn supported desktop hosts, users can select accessible private documents through native composer mentions and ask questions grounded in their content. Native composer mentions are not available on mobile. Mention lookup matches document titles and Space names, with up to 20 recent documents for an empty query. Existing ChatGPT tools can generate docs from supplied code and supported connected repositories, search account-accessible Spaces, list pending Autopilot suggestions, and read official Platform Docs. Mention lookup and document reads have no side effects; writes use separate MCP tools after an explicit request and authorization. Provider authorization and repository import remain website workflows.\n\nFor an existing repository-backed Space, ask to check documentation against repository changes. Inspect its branch, affected or selected pages, and maximum credit cost without starting work. After explicit approval, start that quoted paid review, check progress, and open the browser review link. Applying or rejecting changes, approving new pages, resuming, and ending reviews remain browser actions.",
        "developerName": "DocuWriter.ai",
        "category": "Developer Tools",
        "capabilities": [
          "Generate documentation",
          "Mention and search Space documents",
          "Review repository documentation updates",
          "List Autopilot suggestions",
          "Find official product docs"
        ],
        "websiteURL": "https://www.docuwriter.ai/",
        "supportURL": "https://www.docuwriter.ai/enterprise",
        "privacyPolicyURL": "https://app.docuwriter.ai/privacy-policy",
        "termsOfServiceURL": "https://app.docuwriter.ai/terms-of-service",
        "defaultPrompt": [
          "Show the documentation workspaces available to my DocuWriter account.",
          "How do I configure DocuWriter Autopilot?",
          "Check a documentation Space against its repository and show scope and maximum credits before starting a review."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "onboardingSkill": "./skills/docuwriter-overview/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Mention and ask about a private document in a supported desktop host, not mobile. Prerequisite: the connected reviewer has access to a private Space containing a readable document. Before sending the question, use the native composer mention picker to find the document by title or Space name and select it. The host performs the app-only search; do not ask the model to invoke it or hardcode IDs.",
              "prompt": "What does the attached DocuWriter document say, and what are its key details?",
              "tools_triggered": "search-documentation-mentions",
              "expected_behavior": "Read the already-selected resource's authorized text/markdown content through resources/read at docuwriter://spaces/{space_id}/documents/{document_id}, then answer using that content. Do not publish, edit, or change access to the document."
            },
            {
              "description": "Choose between duplicate document titles in different Spaces using native composer mentions in a supported desktop host, not mobile. Prerequisite: the reviewer can access two Spaces with readable documents sharing a title and distinguishable content. Before sending the question, search the shared title in the composer mention picker, distinguish the results by Space context, and select one from the intended Space. The host performs the app-only search; do not ask the model to invoke it or hardcode IDs.",
              "prompt": "What are the key points of the attached DocuWriter document, and which Space does it belong to?",
              "tools_triggered": "search-documentation-mentions",
              "expected_behavior": "Read only the already-selected document resource and identify its Space. Ground the answer in that document's content without substituting the same-titled document from another Space. Use the selected resource URI rather than inventing IDs."
            },
            {
              "description": "Generate documentation from a small source snippet. Prerequisite: the reviewer is connected to DocuWriter and has generation availability.",
              "prompt": "Document this PHP function and preserve its signature and return behavior: function sum(int $left, int $right): int { return $left + $right; }",
              "tools_triggered": "generate-code-documentation",
              "expected_behavior": "Return Markdown describing sum(int $left, int $right): int, both integer parameters, the integer return value, and that the result is the sum of the inputs."
            },
            {
              "description": "Inspect an existing repository-backed Space before any paid review. Prerequisite: the connected reviewer can manage a paid, non-ZIP Space with an available provider connection. Discover account-authorized IDs; do not create or modify production fixtures. If several Spaces fit, ask which one before inspection.",
              "prompt": "Check a suitable Space against its repository changes. Show the branch, affected or selected pages, and maximum credit cost before starting. Do not start a paid review yet.",
              "tools_triggered": "list-spaces, inspect-documentation-update",
              "expected_behavior": "Discover or clarify the intended authorized Space, inspect it read-only, and report eligibility, repository branch, review mode, page scope and rationale, maximum credits and available credits. Preserve any page selection from the conversation. Do not call start-documentation-update without separate explicit approval of these facts. A quote or read-only annotation is not proof of consent. If a run already exists, explain the conflict and return its browser review link rather than queueing another run."
            },
            {
              "description": "Find a first-party product setup guide. Prerequisite: the DocuWriter MCP server is reachable.",
              "prompt": "How do I connect a Space to Autopilot? Link the official DocuWriter guide.",
              "tools_triggered": "search-docuwriter-platform-docs",
              "expected_behavior": "Explain the documented Space-to-Autopilot setup and link the matching official guide.",
              "expected_output_url": "https://docs.docuwriter.ai/docuwriterai-platform-docs/keep-documentation-current/connect-a-space-to-autopilot"
            }
          ],
          "negative": [
            {
              "description": "Do not trigger for unrelated calendar requests.",
              "prompt": "What meetings do I have tomorrow afternoon?",
              "tools_triggered": null,
              "expected_behavior": "Do not invoke DocuWriter because calendar management is outside its supported workflows."
            },
            {
              "description": "Do not trigger for unrelated personal email requests.",
              "prompt": "Email my manager that I will be late today.",
              "tools_triggered": null,
              "expected_behavior": "Do not invoke DocuWriter because sending personal email is outside its supported workflows."
            },
            {
              "description": "Do not trigger for unrelated server administration.",
              "prompt": "SSH into my server and restart nginx.",
              "tools_triggered": null,
              "expected_behavior": "Do not invoke DocuWriter because server administration is outside its supported workflows."
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "release_notes": "Adds inspect-documentation-update, start-documentation-update and get-documentation-update-status for existing repository-backed Spaces. Inspection shows scope and maximum credits without starting work; an explicitly approved quote starts paid review. Progress and browser handoff keep change decisions in the website. Retains native document mentions, generation, semantic search, Autopilot tools and official product guides."
      },
      "apps": "./.app.json"
    }
  }
}