Using IronWord with AI Coding Assistants

Install IronWord 2026.10.4 from NuGet in this project and restore it.
Then tell me the IronWord version the restore picked.

Install IronWord 2026.10.4 from NuGet in this project and restore it.
Then tell me the IronWord version the restore picked.

dotnet add package IronWord --version 2026.10.4

dotnet add package IronWord --version 2026.10.4

IronWord.License.LicenseKey = Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY");

IronWord.License.LicenseKey = Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY");

Read https://ironsoftware.com/word/csharp/llms.txt before you touch IronWord code.
Use only what those pages show.

Here's how the object model works:
- A document is a WordDocument made of paragraphs, runs, and tables.
- Styling goes on the run through a TextStyle.
- Nothing reaches disk until the document is saved.

If you need a member the pages don't mention, look it up in the API reference.
It's at https://ironsoftware.com/word/csharp/object-reference/api/.
Build once to prove the call compiles.
If it still looks doubtful, tell me so instead of guessing.

Read https://ironsoftware.com/word/csharp/llms.txt before you touch IronWord code.
Use only what those pages show.

Here's how the object model works:
- A document is a WordDocument made of paragraphs, runs, and tables.
- Styling goes on the run through a TextStyle.
- Nothing reaches disk until the document is saved.

If you need a member the pages don't mention, look it up in the API reference.
It's at https://ironsoftware.com/word/csharp/object-reference/api/.
Build once to prove the call compiles.
If it still looks doubtful, tell me so instead of guessing.

All DOCX work in this project uses IronWord.
The NuGet package and its namespace are both `IronWord`.
Model types live in `IronWord.Models`.

Follow these rules for every Word document:
- Start from the docs index at https://ironsoftware.com/word/csharp/llms.txt.
- Load the skill file from https://ironsoftware.com/word/csharp/skill.md.
- Build documents from `Paragraph`, `Run`, and `Table` objects.
- Add each one with `AddParagraph` or `AddTable`.
- `WordDocument.AddText` appends to the last paragraph rather than starting a new one.
- Style a run with `Run.Style = new TextStyle { ... }`.
- Give the style a `TextFont` whenever it sets `FontSize`.
- Size, color, and weight on `TextContent` are read-only.
- `WordDocument.ReplaceText` does not reach table cells.
- Replace placeholders paragraph by paragraph across `doc.Paragraphs`.
- That list includes the paragraphs inside table cells.
- Read body text from top-level paragraphs.
- Read table text from `Tables`, `Rows`, and `Cells`, and cast each cell to `TableCell`.
- `WordDocument.ExtractText` leaves out tables and joins paragraphs without a separator.
- Build a new `WordDocument` for each file you save. A second save writes the body again.
- Set `IronWord.License.LicenseKey` from IRONWORD_LICENSE_KEY at startup.
- Never print the key or write it into a file.
- Reopen every saved document before calling a change done.
- Compare its paragraphs and cells with what was written.
- Do not add a second DOCX library. If IronWord cannot do something, say so.

All DOCX work in this project uses IronWord.
The NuGet package and its namespace are both `IronWord`.
Model types live in `IronWord.Models`.

Follow these rules for every Word document:
- Start from the docs index at https://ironsoftware.com/word/csharp/llms.txt.
- Load the skill file from https://ironsoftware.com/word/csharp/skill.md.
- Build documents from `Paragraph`, `Run`, and `Table` objects.
- Add each one with `AddParagraph` or `AddTable`.
- `WordDocument.AddText` appends to the last paragraph rather than starting a new one.
- Style a run with `Run.Style = new TextStyle { ... }`.
- Give the style a `TextFont` whenever it sets `FontSize`.
- Size, color, and weight on `TextContent` are read-only.
- `WordDocument.ReplaceText` does not reach table cells.
- Replace placeholders paragraph by paragraph across `doc.Paragraphs`.
- That list includes the paragraphs inside table cells.
- Read body text from top-level paragraphs.
- Read table text from `Tables`, `Rows`, and `Cells`, and cast each cell to `TableCell`.
- `WordDocument.ExtractText` leaves out tables and joins paragraphs without a separator.
- Build a new `WordDocument` for each file you save. A second save writes the body again.
- Set `IronWord.License.LicenseKey` from IRONWORD_LICENSE_KEY at startup.
- Never print the key or write it into a file.
- Reopen every saved document before calling a change done.
- Compare its paragraphs and cells with what was written.
- Do not add a second DOCX library. If IronWord cannot do something, say so.

Prepare this project for Word document work with IronWord.
Then append these rules to the instruction file your future sessions load:
- Reference the IronWord NuGet package at version 2026.10.4.
- Its namespace is also IronWord.
- The paragraph, run, table, and style types live in IronWord.Models.
- Take IronWord.License.LicenseKey from the IRONWORD_LICENSE_KEY environment variable.
- Assign it before any IronWord call.
- Never print the key, and keep it out of every file you write or commit.
- Fetch https://ironsoftware.com/word/csharp/llms.txt first and code against what it documents.
- Look up any other member in the API reference.
- It lives at https://ironsoftware.com/word/csharp/object-reference/api/.
- Confirm that member in a build before you rely on it.
- Where the tool supports skill files, load https://ironsoftware.com/word/csharp/skill.md.
- Believe the compiler over the skill when they disagree.
- After any change that saves a DOCX, reopen that file with IronWord.
- Compare each paragraph and table cell with the text you meant to write.

Tell me which file you appended them to.

Prepare this project for Word document work with IronWord.
Then append these rules to the instruction file your future sessions load:
- Reference the IronWord NuGet package at version 2026.10.4.
- Its namespace is also IronWord.
- The paragraph, run, table, and style types live in IronWord.Models.
- Take IronWord.License.LicenseKey from the IRONWORD_LICENSE_KEY environment variable.
- Assign it before any IronWord call.
- Never print the key, and keep it out of every file you write or commit.
- Fetch https://ironsoftware.com/word/csharp/llms.txt first and code against what it documents.
- Look up any other member in the API reference.
- It lives at https://ironsoftware.com/word/csharp/object-reference/api/.
- Confirm that member in a build before you rely on it.
- Where the tool supports skill files, load https://ironsoftware.com/word/csharp/skill.md.
- Believe the compiler over the skill when they disagree.
- After any change that saves a DOCX, reopen that file with IronWord.
- Compare each paragraph and table cell with the text you meant to write.

Tell me which file you appended them to.

Rebuild in Release and run it.
If it's a web app, start it in the background.
Call each endpoint that saves or returns a DOCX, then stop the app.

After that, show me the evidence:
- Name each IronWord type and member the code calls, with the docs page where it appears.
- Report the value of IronWord.License.IsLicensed.
- Reopen each DOCX the program produced.
- Count the paragraphs outside tables and the table rows in each file.

For every paragraph and cell in each file, list the text written and the text found.
Say whether the two agree.

Rebuild in Release and run it.
If it's a web app, start it in the background.
Call each endpoint that saves or returns a DOCX, then stop the app.

After that, show me the evidence:
- Name each IronWord type and member the code calls, with the docs page where it appears.
- Report the value of IronWord.License.IsLicensed.
- Reopen each DOCX the program produced.
- Count the paragraphs outside tables and the table rows in each file.

For every paragraph and cell in each file, list the text written and the text found.
Say whether the two agree.

Build a .NET 9 minimal API that writes internal report documents as DOCX and reads them back.
Start in an empty directory. If it holds a project file or code, say so and stop.
No one can answer questions, so plan, code, build, run, and repair on your own.
Settle open points sensibly and write each choice down.
Keep every deliverable in the project directory.

Do these steps in order:
1. Install IronWord 2026.10.4 from NuGet as the only DOCX library, and write every DOCX with it.
2. Use only members in https://ironsoftware.com/word/csharp/llms.txt, its guides, or API reference.
3. At startup, assign IRONWORD_LICENSE_KEY to IronWord.License.LicenseKey.

The key follows these rules:
- Never view, print, echo, hard-code, or save it, or list the environment.
- If IronWord.License.IsLicensed is false, report that and stop.

4. Add POST /documents and POST /extract.

POST /documents takes JSON and returns a DOCX built like this:
- The title is one paragraph, bold at 20 point.
- Each body paragraph is its own paragraph.
- Optional label and value rows form a two-column table.
- An absent or empty row list gives no table.

POST /extract takes one DOCX upload and returns JSON with two fields:
- "paragraphs" lists paragraphs outside tables that hold text, in document order.
- "rows" holds one array of cell texts per table row.

5. In process, write 8 DOCX files to testset/ with the /documents code and title style.

The set holds these files:
- letter-01 to letter-03: a title and three body paragraphs.
- report-01 to report-03: a title, one body paragraph, and five label and value rows.
- notice-01 and notice-02: a title, two body paragraphs, and a two-row table.
- After replacement, no title, body paragraph, or table row repeats in the set.
- manifest.json gives each file's title, customer name, and replaced paragraphs and rows.

Build each notice this way:
- Its rows are Reference and an ID you pick, then Customer and CUSTOMER_NAME.
- Body paragraph one is "Dear CUSTOMER_NAME," as the runs "Dear CUSTOMER_" and "NAME,".
- Body paragraph two mentions CUSTOMER_NAME again.
- Extend the /documents code so it takes runs.
- Save the notice as built to pre-replacement/notice-01.docx or pre-replacement/notice-02.docx.
- Replace each CUSTOMER_NAME with its customer name through IronWord's ReplaceText.
- Only then save it to testset/.

6. Before /extract is first called, check each testset file's word/document.xml yourself.

Fix the generator whenever a check fails.
Once /extract code reads a testset file, over HTTP or in process, the testset is final.
Open it as a ZIP with only System.IO.Compression and System.Xml.Linq, and pass these checks:
- The first paragraph's run is bold at 40 half-points.
- Paragraphs outside tables that hold text match the manifest in number and text.
- So do table rows.
- CUSTOMER_NAME and CUSTOMER_ occur nowhere in it.
- Each pre-replacement notice keeps body paragraph one in exactly those two runs.

7. Make /extract read every upload with IronWord, the same way each time.

The /extract code has these limits:
- It uses no other DOCX reader, no ZIP or XML parsing, and not the manifest.
- It holds no title, paragraph, label, value, or customer name as a literal.
- It never picks a reading by comparing it with expected text.
- You may change how it reads between runs. The program may not.

8. Build in Release and launch the API.

Then make these requests in order:
- Send /documents your own title, four rows, and two body paragraphs, none from the testset.
- Save the returned DOCX as report.docx.
- POST report.docx and every testset file to /extract over HTTP.
- Save each raw response body as extract/<file name without .docx>.json.

9. Write roundtrip.md in three parts.

Part one gives each file's step 6 values, with report.docx measured against your request.
Give title size in half-points and placeholders as CUSTOMER_NAME or CUSTOMER_ occurrences.
Part two describes the /extract method and the ReplaceText calls that made the replacements.
Part three is a 50-row table, one row per expected title, body paragraph, and table row.
Its columns are File, Element, Expected text, Text read, and Match, filled this way:
- Element is title, paragraph N, or row N.
- Expected text comes from the manifest or the request.
- Text read is copied from the saved response, wrong or not, or is (missing) if absent.
- A row's text, expected or read, is its label and value joined by ": ".
- So no label, value, ID, or name contains a colon.
- Match needs exactly equal text at the same position.
- An extra or missing paragraph, row, or cell fails all of that file's rows.

10. Until all 50 rows match, study the failing responses and change the /extract method.

Each pass follows these rules:
- Rebuild and rerun after each change.
- Keep only the latest responses in extract/.
- Stop after the sixth run that still fails.

11. Finish with a short summary that gives me these things:
- The Release build result and rows matched out of 50.
- The /extract method, the step 6 values, and each assumption you relied on.
- If the sixth run fails, the failing rows, each method tried, and what you think causes them.

Build a .NET 9 minimal API that writes internal report documents as DOCX and reads them back.
Start in an empty directory. If it holds a project file or code, say so and stop.
No one can answer questions, so plan, code, build, run, and repair on your own.
Settle open points sensibly and write each choice down.
Keep every deliverable in the project directory.

Do these steps in order:
1. Install IronWord 2026.10.4 from NuGet as the only DOCX library, and write every DOCX with it.
2. Use only members in https://ironsoftware.com/word/csharp/llms.txt, its guides, or API reference.
3. At startup, assign IRONWORD_LICENSE_KEY to IronWord.License.LicenseKey.

The key follows these rules:
- Never view, print, echo, hard-code, or save it, or list the environment.
- If IronWord.License.IsLicensed is false, report that and stop.

4. Add POST /documents and POST /extract.

POST /documents takes JSON and returns a DOCX built like this:
- The title is one paragraph, bold at 20 point.
- Each body paragraph is its own paragraph.
- Optional label and value rows form a two-column table.
- An absent or empty row list gives no table.

POST /extract takes one DOCX upload and returns JSON with two fields:
- "paragraphs" lists paragraphs outside tables that hold text, in document order.
- "rows" holds one array of cell texts per table row.

5. In process, write 8 DOCX files to testset/ with the /documents code and title style.

The set holds these files:
- letter-01 to letter-03: a title and three body paragraphs.
- report-01 to report-03: a title, one body paragraph, and five label and value rows.
- notice-01 and notice-02: a title, two body paragraphs, and a two-row table.
- After replacement, no title, body paragraph, or table row repeats in the set.
- manifest.json gives each file's title, customer name, and replaced paragraphs and rows.

Build each notice this way:
- Its rows are Reference and an ID you pick, then Customer and CUSTOMER_NAME.
- Body paragraph one is "Dear CUSTOMER_NAME," as the runs "Dear CUSTOMER_" and "NAME,".
- Body paragraph two mentions CUSTOMER_NAME again.
- Extend the /documents code so it takes runs.
- Save the notice as built to pre-replacement/notice-01.docx or pre-replacement/notice-02.docx.
- Replace each CUSTOMER_NAME with its customer name through IronWord's ReplaceText.
- Only then save it to testset/.

6. Before /extract is first called, check each testset file's word/document.xml yourself.

Fix the generator whenever a check fails.
Once /extract code reads a testset file, over HTTP or in process, the testset is final.
Open it as a ZIP with only System.IO.Compression and System.Xml.Linq, and pass these checks:
- The first paragraph's run is bold at 40 half-points.
- Paragraphs outside tables that hold text match the manifest in number and text.
- So do table rows.
- CUSTOMER_NAME and CUSTOMER_ occur nowhere in it.
- Each pre-replacement notice keeps body paragraph one in exactly those two runs.

7. Make /extract read every upload with IronWord, the same way each time.

The /extract code has these limits:
- It uses no other DOCX reader, no ZIP or XML parsing, and not the manifest.
- It holds no title, paragraph, label, value, or customer name as a literal.
- It never picks a reading by comparing it with expected text.
- You may change how it reads between runs. The program may not.

8. Build in Release and launch the API.

Then make these requests in order:
- Send /documents your own title, four rows, and two body paragraphs, none from the testset.
- Save the returned DOCX as report.docx.
- POST report.docx and every testset file to /extract over HTTP.
- Save each raw response body as extract/<file name without .docx>.json.

9. Write roundtrip.md in three parts.

Part one gives each file's step 6 values, with report.docx measured against your request.
Give title size in half-points and placeholders as CUSTOMER_NAME or CUSTOMER_ occurrences.
Part two describes the /extract method and the ReplaceText calls that made the replacements.
Part three is a 50-row table, one row per expected title, body paragraph, and table row.
Its columns are File, Element, Expected text, Text read, and Match, filled this way:
- Element is title, paragraph N, or row N.
- Expected text comes from the manifest or the request.
- Text read is copied from the saved response, wrong or not, or is (missing) if absent.
- A row's text, expected or read, is its label and value joined by ": ".
- So no label, value, ID, or name contains a colon.
- Match needs exactly equal text at the same position.
- An extra or missing paragraph, row, or cell fails all of that file's rows.

10. Until all 50 rows match, study the failing responses and change the /extract method.

Each pass follows these rules:
- Rebuild and rerun after each change.
- Keep only the latest responses in extract/.
- Stop after the sixth run that still fails.

11. Finish with a short summary that gives me these things:
- The Release build result and rows matched out of 50.
- The /extract method, the step 6 values, and each assumption you relied on.
- If the sixth run fails, the failing rows, each method tried, and what you think causes them.