add_project_section
Add and position new sections in project main.md files for clear and organized documentation. Ideal for introducing topics, expanding guidelines, or creating structured content groups with flexible placement options.
Instructions
Add a new section to the project main.md file with precise positioning control.
When to use this tool:
Introducing new topics or guidelines to project
Expanding project documentation systematically
Adding configuration sections
Creating new instruction categories
Organizing content into new logical groups
Key features:
Flexible positioning (before/after/end)
Maintains document structure and flow
Non-destructive addition
Reference-based positioning for precision
You should:
Choose meaningful section headers with "## " prefix
Decide optimal position for the new section
Use reference_header for precise placement
Keep sections focused on single topics
Follow existing section naming conventions
Consider document flow and readability
Add sections progressively, not all at once
DO NOT use when:
Section already exists (use update_project_section)
Content belongs in existing section
Unsure about section organization
Position options: "before", "after", "end" (default) Returns: {success: bool, message?: str, error?: str}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The content for the new section | |
| position | No | Where to insert the section (default: "end") | |
| project_id | Yes | The project identifier | |
| reference_header | No | The section header to use as reference point for before/after positioning | |
| section_header | Yes | The new section header (e.g., "## Configuration") |