agentic-net-examples / lists
AGENTS.md4 starsChanged 2 months agoMITView on GitHub
Verified C# examples for lists scenarios in Aspose.Words for .NET
3 other projects use a version of this.
Adopted by
Most recently taken up by
- eddmann/jeevestheir own version, first seen Oct 8, 2026
- moasq/ios-dev-agenttheir own version, first seen May 26, 2026
- ztnkv/personal-operating-systemtheir own version, first seen May 12, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- moasq/ios-dev-agent★ 4same name
- eddmann/jeeves★ 2same name
- ztnkv/personal-operating-system★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,774 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository29 other files it gives its agents.
- aspose-words-examplesAGENTS.md
- barcode-imageAGENTS.md
- chartsAGENTS.md
- commentsAGENTS.md
- comparisonAGENTS.md
- content-controlAGENTS.md
- conversionAGENTS.md
- extractionAGENTS.md
- find-and-replaceAGENTS.md
- fontsAGENTS.md
- form-fieldsAGENTS.md
- hyphenationAGENTS.md
- imagesAGENTS.md
- join-documentsAGENTS.md
- linq-reportingAGENTS.md
- mail-mergeAGENTS.md
- officemathAGENTS.md
- ole-objectsAGENTS.md
- paragraphsAGENTS.md
- programming-with-documentsAGENTS.md
- rangeAGENTS.md
- renderingAGENTS.md
- security-and-protectionAGENTS.md
- shapesAGENTS.md
- split-documentAGENTS.md
- track-changesAGENTS.md
- vba-macrosAGENTS.md
- watermarkAGENTS.md
- working-with-tableAGENTS.md
The file
We split this AGENTS.md into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Do not reference APIs that are not present in Aspose.Words 26.10.0, such as ListFormat.IncreaseIndent, ListFormat.DecreaseIndent, …
- Distinctive: line 18
Do not omit the assignment of builder.ListFormat.List before writing list items.
- Distinctive: line 20
Prefer simple, verifiable workflows over speculative formatting shortcuts.
- Distinctive: line 31
Use the simplest workflow that satisfies the task.
- Distinctive: line 246
Update the example code whenever a new Aspose.Words version is released to reflect any API changes and keep the documentation in sync.
≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Keep what fits and drop the rest. Your version, ready for your agents.
Files
AGENTS.md
AGENTS.md - Lists
Purpose
Provide an AI coding assistant with concise, authoritative guidance for generating and managing Word lists in Aspose.Words, ensuring that generated code compiles against version 26.10.0 and follows best-practice patterns for list creation, nesting, formatting, and cleanup.
Non-negotiable conventions
- Do not reference APIs that are not present in Aspose.Words 26.10.0, such as ListFormat.IncreaseIndent, ListFormat.DecreaseIndent, ListNumberStyle, or ListLevel.StartingNumber.
- Do not omit the assignment of builder.ListFormat.List before writing list items.
- Bootstrap local sample inputs for existing-file, folder, stream, image, and data workflows.
- Prefer simple, verifiable workflows over speculative formatting shortcuts.
Recommended workflow selection
- Numbered List Workflow workflow: 2 examples
- Bulleted List Workflow workflow: 1 examples
- Nested List Workflow workflow: 17 examples
- List Formatting Workflow workflow: 5 examples
- General List Workflow workflow: 4 examples
- Numbering Control Workflow workflow: 1 examples
Use the simplest workflow that satisfies the task.
Validation priorities
- Count Paragraph nodes where para.ListFormat.IsListItem is true to verify that the expected number of list items were generated.
File-to-task reference
create-a-default-numbered-list-in-a-word-document-using-documentbuilder-listformat-applynu.cs- Task: Create a default numbered list in a Word document using DocumentBuilder.ListFormat.ApplyNumberDefault method.
- Workflow: numbered-list-workflow
- Outputs: docx
- Selected engine: mcp
apply-a-default-bulleted-list-to-paragraphs-with-documentbuilder-listformat-applybulletdef.cs- Task: Apply a default bulleted list to paragraphs with DocumentBuilder.ListFormat.ApplyBulletDefault method for formatting.
- Workflow: bulleted-list-workflow
- Outputs: docx
- Selected engine: mcp
set-listlevelnumber-to-three-before-adding-a-paragraph-to-create-a-third-level-list-item-i.cs- Task: Set ListLevelNumber to three before adding a paragraph to create a third-level list item in the document.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
increase-list-indent-programmatically-using-documentbuilder-listformat-increaseindent-to-m.cs- Task: Increase list indent programmatically using DocumentBuilder.ListFormat.IncreaseIndent to move paragraph deeper within the current list structure.
- Workflow: list-formatting-workflow
- Outputs: docx
- Selected engine: mcp
decrease-list-indent-with-documentbuilder-listformat-decreaseindent-to-promote-paragraph-t.cs- Task: Decrease list indent with DocumentBuilder.ListFormat.DecreaseIndent to promote paragraph to higher level in the outline.
- Workflow: list-formatting-workflow
- Outputs: docx
- Selected engine: mcp
remove-numbering-from-a-paragraph-by-calling-documentbuilder-listformat-removenumbers-meth.cs- Task: Remove numbering from a paragraph by calling DocumentBuilder.ListFormat.RemoveNumbers method to stop list formatting.
- Workflow: numbered-list-workflow
- Outputs: docx
- Selected engine: mcp
create-a-custom-list-object-configure-its-levels-and-add-it-to-document-lists-collection.cs- Task: Create a custom List object, configure its levels, and add it to Document.Lists collection.
- Workflow: nested-list-workflow
- Outputs: doc
- Selected engine: mcp
add-a-new-list-to-the-document-s-listcollection-and-assign-it-to-multiple-paragraphs-to-sh.cs- Task: Add a new List to the document's ListCollection and assign it to multiple paragraphs to share formatting.
- Workflow: general-list-workflow
- Outputs: docx
- Selected engine: mcp
assign-an-existing-list-to-a-paragraph-by-setting-paragraph-listformat-list-property-to-ap.cs- Task: Assign an existing List to a paragraph by setting Paragraph.ListFormat.List property to apply the desired list style.
- Workflow: list-formatting-workflow
- Outputs: docx
- Selected engine: mcp
clone-an-existing-list-modify-its-level-start-values-and-apply-the-cloned-list-to-new-sect.cs- Task: Clone an existing List, modify its level start values, and apply the cloned list to new sections.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
set-numberstyle-of-a-listlevel-to-upperroman-to-generate-roman-numeral-list-items.cs- Task: Set NumberStyle of a ListLevel to UpperRoman to generate Roman numeral list items.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: existing_repo
apply-a-custom-bullet-character-to-a-list-by-setting-listlevel-numberstyle-to-bullet-and-d.cs- Task: Apply a custom bullet character to a list by setting ListLevel.NumberStyle to Bullet and defining BulletChar.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: existing_repo
define-startingnumber-for-a-listlevel-to-begin-numbering-at-five-instead-of-default-one.cs- Task: Define StartingNumber for a ListLevel to begin numbering at five instead of default one.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
restart-numbering-for-each-new-section-by-resetting-listlevel-startingnumber-before-applyi.cs- Task: Restart numbering for each new section by resetting ListLevel.StartingNumber before applying the list.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
create-a-numbered-list-that-restarts-numbering-at-each-new-chapter-by-resetting-startingnu.cs- Task: Create a numbered list that restarts numbering at each new chapter by resetting StartingNumber on chapter start.
- Workflow: numbering-control-workflow
- Outputs: docx
- Selected engine: mcp
create-a-nine-level-hierarchical-list-by-defining-properties-for-each-listlevel-up-to-leve.cs- Task: Create a nine-level hierarchical list by defining properties for each ListLevel up to level nine.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
create-a-multi-level-list-with-alternating-bullet-and-number-styles-by-configuring-each-li.cs- Task: Create a multi-level list with alternating bullet and number styles by configuring each ListLevel individually.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: llm
adjust-listlevel-indentation-by-setting-listlevel-indentation-to-36-points-for-proper-alig.cs- Task: Adjust ListLevel indentation by setting ListLevel.Indentation to 36 points for proper alignment.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
apply-a-custom-tab-stop-to-list-levels-to-align-text-after-numbers-using-listlevel-tabposi.cs- Task: Apply a custom tab stop to list levels to align text after numbers using ListLevel.TabPosition property.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
configure-tabposition-of-a-listlevel-to-72-points-to-align-text-after-list-number.cs- Task: Configure TabPosition of a ListLevel to 72 points to align text after list number.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
validate-that-each-list-in-a-document-does-not-exceed-nine-levels-to-comply-with-api-const.cs- Task: Validate that each list in a document does not exceed nine levels to comply with API constraints.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
implement-error-handling-for-attempts-to-create-more-than-nine-list-levels-catching-the-re.cs- Task: Implement error handling for attempts to create more than nine list levels, catching the resulting exception.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
ensure-ooxmlcompliance-is-set-higher-than-ecma376-before-saving-document-to-retain-custom.cs- Task: Ensure OoxmlCompliance is set higher than Ecma376 before saving document to retain custom list settings.
- Workflow: general-list-workflow
- Outputs: docx
- Selected engine: mcp
check-document-ooxmlcompliance-property-and-set-to-higher-than-ecma376-when-modifying-list.cs- Task: Check document OoxmlCompliance property and set to higher than Ecma376 when modifying list definitions.
- Workflow: general-list-workflow
- Outputs: docx
- Selected engine: existing_repo
retrieve-a-specific-list-from-document-lists-by-its-id-and-adjust-its-level-properties-pro.cs- Task: Retrieve a specific List from Document.Lists by its ID and adjust its level properties programmatically.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
iterate-through-document-lists-collection-to-modify-all-list-definitions-uniformly-across.cs- Task: Iterate through Document.Lists collection to modify all list definitions uniformly across the document.
- Workflow: general-list-workflow
- Outputs: docx
- Selected engine: mcp
apply-a-uniform-list-style-to-all-lists-by-iterating-over-document-lists-and-updating-each.cs- Task: Apply a uniform list style to all lists by iterating over Document.Lists and updating each level.
- Workflow: list-formatting-workflow
- Outputs: docx
- Selected engine: mcp
programmatically-increase-list-level-depth-for-a-paragraph-using-documentbuilder-listforma.cs- Task: Programmatically increase list level depth for a paragraph using DocumentBuilder.ListFormat.IncreaseIndent within a loop.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
programmatically-decrease-list-level-depth-for-a-paragraph-using-documentbuilder-listforma.cs- Task: Programmatically decrease list level depth for a paragraph using DocumentBuilder.ListFormat.DecreaseIndent inside a conditional.
- Workflow: nested-list-workflow
- Outputs: docx
- Selected engine: mcp
programmatically-remove-list-formatting-from-selected-paragraphs-while-preserving-their-in.cs- Task: Programmatically remove list formatting from selected paragraphs while preserving their indentation using ListFormat.RemoveNumbers.
- Workflow: list-formatting-workflow
- Outputs: docx
- Selected engine: mcp
Common failure patterns and preferred agent fixes
- Use of removed or renamed list APIs
- Symptom: Compilation fails with CS1061 because ListFormat does not contain IncreaseIndent, DecreaseIndent, or ListNumberStyle members.
- Root cause: The code references API members that were removed or renamed in the current Aspose.Words version.
- Preferred fix: Replace the missing members with supported alternatives: control nesting via ListFormat.ListLevelNumber and use NumberStyle enum values such as NumberStyle.Bullet or NumberStyle.UppercaseRoman.
- Prevention: Consult the Aspose.Words 26.10.0 documentation for the exact member names before writing list-related code.
- Incorrect list level property names
- Symptom: Compilation fails with CS1061 for ListLevel.StartingNumber, ListLevel.Indentation, or ListLevel.BulletChar.
- Root cause: Older property names were used; the current API uses ListLevel.StartAt for the starting number, ListLevel.NumberPosition/TextPosition for indentation, and NumberFormat for custom bullet characters.
- Preferred fix: Use ListLevel.StartAt to set the initial number, adjust ListLevel.NumberPosition and ListLevel.TextPosition for indentation, and set ListLevel.NumberFormat to a custom character string.
- Prevention: Reference the ListLevel class in the official API reference to ensure property names are up-to-date.
- Missing list assignment before writing items
- Symptom: Paragraphs are added but appear as plain text without list numbering or bullets.
- Root cause: builder.ListFormat.List was never set, so the builder does not know which list to apply.
- Preferred fix: Assign the List object to builder.ListFormat.List immediately before writing the first list paragraph.
- Prevention: Always set builder.ListFormat.List as the first step of any list-creation workflow.
- Failure to clear list formatting
- Symptom: Subsequent paragraphs unintentionally continue the previous list style.
- Root cause: builder.ListFormat.RemoveNumbers was not called after the list sequence.
- Preferred fix: Invoke builder.ListFormat.RemoveNumbers right after the last list item and before adding non-list content.
- Prevention: Include a RemoveNumbers call in every list workflow to reset the builder's list state.
- Incorrect OoxmlCompliance usage
- Symptom: Compilation fails with CS1061 because CompatibilityOptions or Document does not expose an OoxmlCompliance property.
- Root cause: The property was removed from the API; compliance is now controlled via SaveOptions.
- Preferred fix: When saving, create a DocxSaveOptions instance and set its Compliance property to OoxmlCompliance.Iso29500_2008_Strict (or a later enum value).
- Prevention: Use SaveOptions to configure compliance settings instead of accessing non-existent Document members.
Build and run contract
- Target framework:
net8.0 - Primary package:
Aspose.Words26.10.0
Command reference
dotnet new console -n ExampleProject --framework net8.0
cd ExampleProject
dotnet add package Aspose.Words --version 26.10.0Copy-Item ..\lists\<example-file>.cs .\Program.csdotnet build --configuration Release --verbosity minimal
dotnet run --configuration Release --no-buildCategory update guidance
- Update the example code whenever a new Aspose.Words version is released to reflect any API changes and keep the documentation in sync.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.