diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/extensions/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/extensions/package-info.java
new file mode 100644
index 000000000000..7b4aafe562cf
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/extensions/package-info.java
@@ -0,0 +1,34 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides support for Maven core extensions configuration and management.
+ * Core extensions can be configured through {@code .mvn/extensions.xml} in the project
+ * base directory to enhance Maven's capabilities during build execution.
+ *
+ * <p>This package contains classes for:</p>
+ * <ul>
+ *   <li>Extension configuration model</li>
+ *   <li>Extension loading and validation</li>
+ *   <li>Extension lifecycle management</li>
+ * </ul>
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.extensions;
diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/logging/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/logging/package-info.java
new file mode 100644
index 000000000000..e2db461d8836
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/logging/package-info.java
@@ -0,0 +1,34 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides early-stage logging capabilities for Maven CLI operations.
+ * These logging facilities are used during Maven startup before the full logging
+ * system is initialized.
+ *
+ * <p>This package includes:</p>
+ * <ul>
+ *   <li>Basic logging interfaces and implementations</li>
+ *   <li>Support for different logging levels (DEBUG, INFO, WARN, ERROR)</li>
+ *   <li>Accumulating loggers for deferred output</li>
+ * </ul>
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.logging;
diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvn/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvn/package-info.java
new file mode 100644
index 000000000000..dd191227d125
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvn/package-info.java
@@ -0,0 +1,38 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides the API for the Maven build tool ({@code mvn}).
+ *
+ * <p>This package contains interfaces and classes specific to the main Maven build
+ * tool, which is responsible for project build lifecycle execution and dependency management.</p>
+ *
+ * <p>Key features include:</p>
+ * <ul>
+ *   <li>Build lifecycle execution control</li>
+ *   <li>Project-specific configuration</li>
+ *   <li>Goal execution and phase mapping</li>
+ *   <li>Multi-module build coordination</li>
+ * </ul>
+ *
+ * @see org.apache.maven.api.cli.Tools#MVN_CMD
+ * @see org.apache.maven.api.cli.Tools#MVN_NAME
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.mvn;
diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnenc/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnenc/package-info.java
new file mode 100644
index 000000000000..992b6aa38a55
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnenc/package-info.java
@@ -0,0 +1,37 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides the API for the Maven Password Encryption tool ({@code mvnenc}).
+ *
+ * <p>This package contains interfaces and classes for the password encryption tool,
+ * which helps secure sensitive information in Maven settings and configuration files.</p>
+ *
+ * <p>Key features include:</p>
+ * <ul>
+ *   <li>Password encryption and decryption</li>
+ *   <li>Master password management</li>
+ *   <li>Security settings configuration</li>
+ * </ul>
+ *
+ * @see org.apache.maven.api.cli.Tools#MVNENC_CMD
+ * @see org.apache.maven.api.cli.Tools#MVNENC_NAME
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.mvnenc;
diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnsh/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnsh/package-info.java
new file mode 100644
index 000000000000..571925645555
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnsh/package-info.java
@@ -0,0 +1,39 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides the API for the Maven Shell tool ({@code mvnsh}).
+ *
+ * <p>This package contains interfaces and classes for the interactive Maven shell,
+ * which provides a command-line interface for executing Maven commands and
+ * managing build environments.</p>
+ *
+ * <p>Key features include:</p>
+ * <ul>
+ *   <li>Interactive command-line interface</li>
+ *   <li>Command history and completion</li>
+ *   <li>Built-in shell commands</li>
+ *   <li>Project navigation and management</li>
+ * </ul>
+ *
+ * @see org.apache.maven.api.cli.Tools#MVNSHELL_CMD
+ * @see org.apache.maven.api.cli.Tools#MVNSHELL_NAME
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.mvnsh;
diff --git a/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/package-info.java b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/package-info.java
new file mode 100644
index 000000000000..c94bbe0a1006
--- /dev/null
+++ b/api/maven-api-cli/src/main/java/org/apache/maven/api/cli/package-info.java
@@ -0,0 +1,44 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides the API for Maven's command-line interface and tools.
+ *
+ * <p>This package contains interfaces and classes for:</p>
+ * <ul>
+ *   <li>Command-line argument parsing and processing</li>
+ *   <li>Maven tool invocation ({@code mvn}, {@code mvnenc}, {@code mvnsh})</li>
+ *   <li>Core extensions configuration</li>
+ *   <li>Early-stage logging before the full Maven logging system is initialized</li>
+ * </ul>
+ *
+ * <p>The main components are:</p>
+ * <ul>
+ *   <li>{@link org.apache.maven.api.cli.Invoker} - Base interface for executing Maven tools</li>
+ *   <li>{@link org.apache.maven.api.cli.Parser} - Processes command-line arguments into invoker requests</li>
+ *   <li>{@link org.apache.maven.api.cli.Options} - Represents Maven configuration options</li>
+ *   <li>{@link org.apache.maven.api.cli.extensions.CoreExtensions} - Manages Maven core extensions</li>
+ * </ul>
+ *
+ * <p>Core extensions can be configured through {@code .mvn/extensions.xml} in the project base directory
+ * to enhance Maven's capabilities during build execution.</p>
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli;
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/feature/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/feature/package-info.java
new file mode 100644
index 000000000000..b10b38ad3cc3
--- /dev/null
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/feature/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides feature flag management and configuration capabilities for Maven core functionality.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.feature;
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/package-info.java
index 8addcd57cae5..5f85ff9ad15b 100644
--- a/api/maven-api-core/src/main/java/org/apache/maven/api/package-info.java
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/package-info.java
@@ -20,6 +20,21 @@
 /**
  * <h2>Maven Core API</h2>
  *
+ * <h3>Session</h3>
+ *
+ * <p>The {@link org.apache.maven.api.Session} interface is the main entry point for Maven operations.
+ * It maintains the state of a Maven execution and provides access to all core services and components.
+ * Sessions are thread-safe and can be obtained in session-scoped components using the
+ * {@link org.apache.maven.api.di.SessionScoped} annotation.</p>
+ *
+ * <p>Key capabilities provided through the Session include:</p>
+ * <ul>
+ *   <li>Access to the current {@link org.apache.maven.api.Project}</li>
+ *   <li>Access to the {@link org.apache.maven.api.LocalRepository} and {@link org.apache.maven.api.RemoteRepository} configurations</li>
+ *   <li>Access to Maven services through {@link org.apache.maven.api.Session#getService(Class)}</li>
+ *   <li>Build configuration and settings</li>
+ * </ul>
+ *
  * <h3>Dependency management</h3>
  *
  * <p>{@link org.apache.maven.api.ArtifactCoordinates} instances are used to locate artifacts in a repository.
@@ -29,8 +44,9 @@
  * <p>{@link org.apache.maven.api.Artifact} instances are the pointed artifacts in the repository.
  * They are created when <dfn>resolving</dfn> an {@code ArtifactCoordinates}. Resolving is the process
  * that selects a particular version and downloads the artifact in the local repository.
- * There are two sub-interfaces, {@link org.apache.maven.api.DownloadedArtifact} which is used when
- * an artifact has been resolved</p>
+ * The {@link org.apache.maven.api.DownloadedArtifact} sub-interface is used when
+ * an artifact has been resolved and {@link org.apache.maven.api.ProducedArtifact} when
+ * an artifact is being produced by a project.</p>
  *
  * <p>{@link org.apache.maven.api.DependencyCoordinates} instances are used to express a dependency.
  * They are a {@code ArtifactCoordinates} completed with information about how the artifact will be used:
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java
index 5a4ed7d59d4b..14d2c7a2ef1c 100644
--- a/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java
@@ -1,4 +1,22 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
  * Maven Plugin Annotations.
  */
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/package-info.java
index 1aaa794cbd1a..1bed56a81bfe 100644
--- a/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/package-info.java
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/plugin/package-info.java
@@ -1,4 +1,22 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
  * Maven Plugin API.
  */
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/services/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/services/package-info.java
new file mode 100644
index 000000000000..228ba1c49076
--- /dev/null
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/services/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Defines core service interfaces that provide essential Maven functionality such as
+ * artifact resolution, dependency management, and build execution. These services
+ * form the backbone of Maven's extensible architecture.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.services;
diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/services/xml/package-info.java b/api/maven-api-core/src/main/java/org/apache/maven/api/services/xml/package-info.java
new file mode 100644
index 000000000000..f3aea327ef20
--- /dev/null
+++ b/api/maven-api-core/src/main/java/org/apache/maven/api/services/xml/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides XML-specific services for reading and writing Maven's configuration files
+ * and descriptors. These services handle XML parsing, transformation, and serialization
+ * while maintaining Maven's model integrity.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.services.xml;
diff --git a/api/maven-api-metadata/src/main/java/org/apache/maven/api/metadata/package-info.java b/api/maven-api-metadata/src/main/java/org/apache/maven/api/metadata/package-info.java
index 68e28d951cf6..b53290b18c2a 100644
--- a/api/maven-api-metadata/src/main/java/org/apache/maven/api/metadata/package-info.java
+++ b/api/maven-api-metadata/src/main/java/org/apache/maven/api/metadata/package-info.java
@@ -1,4 +1,22 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
  * Maven Repository Metadata model.
  */
diff --git a/api/maven-api-model/src/main/java/org/apache/maven/api/model/package-info.java b/api/maven-api-model/src/main/java/org/apache/maven/api/model/package-info.java
index 3c1c61e2130b..b74e0ef3b590 100644
--- a/api/maven-api-model/src/main/java/org/apache/maven/api/model/package-info.java
+++ b/api/maven-api-model/src/main/java/org/apache/maven/api/model/package-info.java
@@ -1,4 +1,22 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
  * Maven Immutable POM (Project Object Model) classes, generated from <code>maven.mdo</code> model.
  * The root class is {@link org.apache.maven.api.model.Model}.
diff --git a/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java
new file mode 100644
index 000000000000..28a7936fed4c
--- /dev/null
+++ b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/annotations/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides annotations for Maven plugin development, including mojo configuration,
+ * parameter definitions, and lifecycle bindings. These annotations are used to
+ * generate plugin descriptors and configure plugin behavior.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.plugin.annotations;
diff --git a/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/lifecycle/package-info.java b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/lifecycle/package-info.java
index eec9c505362c..800376de87fc 100644
--- a/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/lifecycle/package-info.java
+++ b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/lifecycle/package-info.java
@@ -1,5 +1,26 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
- * Maven Plugin forked lifecycle model.
+ * Contains classes for managing plugin-specific lifecycle bindings and forked executions.
+ * This package helps define how plugins can modify or extend Maven's build lifecycle.
+ *
+ * @since 4.0.0
  */
 package org.apache.maven.api.plugin.descriptor.lifecycle;
diff --git a/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/package-info.java b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/package-info.java
index 0435496d0b46..63d55f5447b8 100644
--- a/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/package-info.java
+++ b/api/maven-api-plugin/src/main/java/org/apache/maven/api/plugin/descriptor/package-info.java
@@ -1,5 +1,27 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
- * Maven Plugin descriptor model.
+ * Provides classes for Maven plugin descriptors that define plugin metadata, configuration,
+ * and execution parameters. These descriptors are typically stored in plugin.xml files
+ * within the META-INF/maven directory of plugin JARs.
+ *
+ * @since 4.0.0
  */
 package org.apache.maven.api.plugin.descriptor;
diff --git a/api/maven-api-settings/pom.xml b/api/maven-api-settings/pom.xml
index cb6298b4251e..875efd19dc73 100644
--- a/api/maven-api-settings/pom.xml
+++ b/api/maven-api-settings/pom.xml
@@ -80,7 +80,34 @@ under the License.
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <configuration>
+          <excludes>
+            <exclude>**/package-info.java</exclude>
+          </excludes>
+        </configuration>
+      </plugin>
     </plugins>
   </build>
 
+  <reporting>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <configuration>
+          <excludes>
+            <exclude>**/package-info.java</exclude>
+          </excludes>
+          <sourceFileIncludes>
+            <sourceFileInclude>**/*.java</sourceFileInclude>
+          </sourceFileIncludes>
+          <failOnError>false</failOnError>
+          <quiet>true</quiet>
+        </configuration>
+      </plugin>
+    </plugins>
+  </reporting>
 </project>
diff --git a/api/maven-api-settings/src/main/java/org/apache/maven/api/settings/package-info.java b/api/maven-api-settings/src/main/java/org/apache/maven/api/settings/package-info.java
new file mode 100644
index 000000000000..14782d443861
--- /dev/null
+++ b/api/maven-api-settings/src/main/java/org/apache/maven/api/settings/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Contains classes for managing Maven settings, including global and user-specific
+ * configuration stored in settings.xml files. These settings control repository access,
+ * authentication, proxies, and other Maven runtime behaviors.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.settings;
diff --git a/api/maven-api-spi/src/main/java/org/apache/maven/api/spi/package-info.java b/api/maven-api-spi/src/main/java/org/apache/maven/api/spi/package-info.java
new file mode 100644
index 000000000000..6a4748fa010a
--- /dev/null
+++ b/api/maven-api-spi/src/main/java/org/apache/maven/api/spi/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Defines the Service Provider Interface (SPI) for Maven extensions, allowing
+ * third-party implementations to extend and customize Maven's core functionality
+ * through a stable, versioned API.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.spi;
diff --git a/api/maven-api-toolchain/pom.xml b/api/maven-api-toolchain/pom.xml
index e02a59128110..71177b153003 100644
--- a/api/maven-api-toolchain/pom.xml
+++ b/api/maven-api-toolchain/pom.xml
@@ -74,7 +74,35 @@ under the License.
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <configuration>
+          <excludes>
+            <exclude>**/package-info.java</exclude>
+          </excludes>
+        </configuration>
+      </plugin>
     </plugins>
   </build>
 
+  <reporting>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <configuration>
+          <excludes>
+            <exclude>**/package-info.java</exclude>
+          </excludes>
+          <sourceFileIncludes>
+            <sourceFileInclude>**/*.java</sourceFileInclude>
+          </sourceFileIncludes>
+          <failOnError>false</failOnError>
+          <quiet>true</quiet>
+        </configuration>
+      </plugin>
+    </plugins>
+  </reporting>
+
 </project>
diff --git a/api/maven-api-toolchain/src/main/java/org/apache/maven/api/toolchain/package-info.java b/api/maven-api-toolchain/src/main/java/org/apache/maven/api/toolchain/package-info.java
new file mode 100644
index 000000000000..04661e78d20e
--- /dev/null
+++ b/api/maven-api-toolchain/src/main/java/org/apache/maven/api/toolchain/package-info.java
@@ -0,0 +1,9 @@
+// CHECKSTYLE_OFF: RegexpHeader
+/**
+ * Provides classes for managing Maven toolchains, which allow projects to use specific
+ * tool installations (like JDKs, compilers, or other build tools) across different
+ * environments without hardcoding paths.
+ *
+ * @since 4.0.0
+ */
+package org.apache.maven.api.toolchain;
diff --git a/api/maven-api-xml/src/main/java/org/apache/maven/api/xml/package-info.java b/api/maven-api-xml/src/main/java/org/apache/maven/api/xml/package-info.java
index db25d3a153a7..11ecfc229838 100644
--- a/api/maven-api-xml/src/main/java/org/apache/maven/api/xml/package-info.java
+++ b/api/maven-api-xml/src/main/java/org/apache/maven/api/xml/package-info.java
@@ -1,5 +1,27 @@
-// CHECKSTYLE_OFF: RegexpHeader
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 /**
- * Maven immutable XML api.
+ * Provides an immutable XML processing API for Maven, offering classes and interfaces
+ * for reading, manipulating, and writing XML documents in a thread-safe manner.
+ * This package is used extensively for POM, settings, and other Maven configuration files.
+ *
+ * @since 4.0.0
  */
 package org.apache.maven.api.xml;